侧边栏壁纸
博主头像
smile博主等级

计科专业20级学生

  • 累计撰写 48 篇文章
  • 累计创建 68 个标签
  • 累计收到 12 条评论

目 录CONTENT

文章目录

【贡献】如何参与GIthub项目

smile
2022-02-03 / 0 评论 / 9 点赞 / 342 阅读 / 1,928 字 / 正在检测是否收录...
温馨提示:
文章最后更新于 2022-10-15,若内容或图片失效,请评论反馈,我们将收到邮箱。部分素材来自网络,若不小心影响到您的利益,请联系我们删除✌️。

参与本项目

⚡前言


💡 关于(先看❗)

Facebook | Website | Blog | Telegram | Twitter | Linkedin | Donate

⚠️ 这是一个菜鸟的成长记录,如果你也想成为工程师,想从事后端的相关工作,或者想了解区块链的相关知识,那么它可以帮助到你😎 —> 喜欢请给个⭐收藏~

🐧 喜欢Go语言的朋友欢迎加入Go语言自学群(QQ群号:141984758GoLang/Go语言/自学交流~

⛓️ 区块链技术(也称之为分布式账本技术),是一种互联网数据库技术,其特点是去中心化,公开透明,信息不可篡改性,隐私匿名性🤑CUB链学社致力打造区块链自学教育平台。

💡 侧边目录支持方式:📚 DocCub 文档、🗃️Github + TOC 导航

👣 存在数学公式无法正常显示问题,强烈推荐📐 MathJax Plugin for Github 插件使用。

📄 保存为 PDF 方式:使用 Chrome 浏览器打开 📚 DocCub 文档 页面,缩起左侧目录-右键 - 打印 - 选择目标打印机是另存为PDF - 保存 —— 🖨️以Go语言第一节打印效果预览.pdf

🙏 仓库内容如有错误或改进欢迎 issue 或 pr,建议或讨论可在 #10 提出。由于本人水平有限,仓库中的知识点有来自本人原创、读书笔记、书籍、博文等,非原创均已标明出处,如有遗漏,请 issue 提出。本仓库遵循 CC BY-NC-SA 4.0(署名 - 非商业性使用 - 相同方式共享) 协议,转载请注明出处,不得用于商业目的。


我们都是这个仓库未来很有潜力的客户,或者是贡献者,谢谢你选择了加入C-UB社区,我们将会一起合作,未来我们将会考虑以区块链为底层搭建一个全民学习平台,我们每一个人都将会是这个社区的构建着,将会推动c-universal blockchain(链学) 社区的发展和进步~

  1. 如果你对本项目有任何建议或发现文中内容有误的,欢迎提交 issues 进行指正。
  2. 对于文中我没有涉及到知识点,欢迎提交 PR。

或许我们会很疑惑?

在我们参与贡献的时候,如果克隆了**🧷 cs-awesome-Block_Chain项目,但是每次获取上游代码很麻烦怎么办?如何提交有意思的代码?这篇文章将会解决这个问题~⬇️ **

⚡提前需要你…

排版

笔记内容按照 中文文案排版指北 进行排版,以保证内容的可读性。

不使用 ![]() 这种方式来引用图片,而是用 <img> 标签。一方面是为了能够控制图片以合适的大小显示,另一方面是因为 GFM 不支持 <center> ![]() </center> 这种方法让图片居中显示,只能使用 <div align="center"> <img src=""/> </div> 达到居中的效果。

谷歌代码规范

🧷 谷歌代码规范可以说是公认的规范,也是目前大多数企业都以为标准~

对于大型程序,我们需要对 🔥软件工程有一定的了解

协议许可

所有内容遵循CC-BY-SA 3.0协议(署名-相同方式共享)©

⚡贡献步骤

我们的fork,如何保证实时的同步上游?🧷这篇教会你 保持自己github的forks自动和上游仓库同步并推送到 gitee

📮 你甚至可以通过 🧷GitHub 的actions ci/cd 玩出更多花样~

💡 步骤

  1. 首先在Githubfork本仓库到你的仓库
  2. git clone克隆到本地
  3. 在本地修改对应的代码
  4. git push到自己的仓库
  5. 在自己的仓库进行pull request的操作

Github会首先比较你仓库中的项目与目的项目的区别,并且会检查这两者之间是否可以进行合并操作

等了一会之后,Github提示Able to merge可以进行合并后,你就可以点击Create pull request了。

这里会让你填一个对你修改代码的一个说明,然后就可以真正的创建一个pull request了(点击这个Create pull request按钮)

⚡你还可以

  1. 重新创建一个分支

  2. 分支下面修改

  3. 提交代码

⚡ 如果你是在CubDoc文档中

⚠️ 例如:你是在以下的文档中~

⬇️ 那么你就更容易了,你可以选择下面两种方法:

直接修改,上传

image-20221015232042494

⬇️ 继续在GitHub中直接修改md文件,然后提交:

image-20221015232445350

clone到本地修改

  1. 首先fork文档所所在仓库地址到自己的仓库(查看源码)
  2. clone刚刚fork到自己账户的仓库
  3. 在本地进行修改,记住经常pull上游的代码
  4. 提交本地的代码到自己的仓库
  5. 将自己的仓库贡献到我们的仓库

📜 对上面的解释

我们需要经常pull保持分支所在最新,可以看🧷这篇教会你 保持自己github的forks自动和上游仓库同步并推送到 gitee

将自己的仓库贡献到我们的仓库只需要:

image-20221015233657581

我们希望什么样的request?

优化已有代码或者文档

  1. 补充和分享项目笔记
  2. 修改错误的代码
  3. 给看不懂的地方一些补充和说明

提醒⚠️

push代码之前 一定要 先pull最新代码,否则提交的pr可能会有删除其他push的操作。

一个pr 不要修改过多文件,因为一旦有一个 文件修改有问题,就不能合入,影响其他文件的合入了。

git add之前,要git diff 查看一下,本次提交所修改的代码是不是 自己修改的,是否 误删,或者误加的文件。

提交代码,不要使用git push -f (或者是--force )这种命令,要足够了解 -f 强制提交覆盖远程意味着什么。

不用非要写出牛逼的代码才能提交PR,只要发现文章中有任何问题,或者错别字,都欢迎提交PR,成为contributor

commit 时建议以 “contributor-name : subject”,比如 小明 : linux学习笔记。然后 push 上来,最后提交一个 pull request。

⚡参与项目

⚡联系我

Facebook | Website | Blog | Telegram | Twitter | Linkedin | Donate

English | 中文

Repography logo / Structure

Structure

9

评论区