最近沉迷 flutter,偶尔换换口味,看看 github

很多知名的开源项目落户于 github,那么为什么呢,人云亦云吗?

不一定, github 的工作流很强大.能够帮助我们更加清晰工作流程

https://help.github.com/categories/managing-your-work-on-github/

首先官方链接在此,英文好的直接去看


另外还有一个帮助你学习 github 的小机器人

https://lab.github.com/install

这个小机器人能帮你系统的了解一些 github 的工作流和 github 的一些基本功能

比如 github 仓库的元数据修改,关键字修改,github pages 的发布

工作流包括 issues 中的

PR 整体过程中 分派工作/审核/修改意见/冲突处理/merge 代码的流程,强烈建议 github 用的不好的人先去梳理一下

issue 篇

常规的创建之类的就不说了,说一些你日常中看不到的东西,或者说看见了,但是不知道怎么玩出来的

不会包含所有的东西,但是会有一些很神奇的效果

通过代码创建一个 issue

比如我在某行代码发现了一个错误, 那么我可以直接在 github 中选中这个代码,然后开启一个 issue

  1. 点击行号

  2. open new issue

图片

图片

图片

通过这几个步骤,我们能看到,我们创建了一个指向改行的错误,这样开发者就能很简单的定位到该行,并且可以直观的在 issue 中看到该行代码,方便开发者定位

示例

创建一个永久可见的代码连接

图片

图片

提交后就可以看到了

图片

示例

TODO List 进度条

有的时候我们会需要使用 issue 来记录我们的开发过程,或者功能需求来提醒我们什么没做

使用类似如下的写法来创建即可

- [X] 第一项工作
- [ ] 第二项工作
- [X] 第三项工作
- [X] 第四项工作

成功后是这样的

图片

然后这个是可以鼠标直接点击/拖动的

图片

图片

好处就是可以在列表中直接看到进度条

图片

示例

使用关键字关闭 issue

有如下的关键字可以用于关闭 issue

close closes closed fix fixes fixed resolve resolves resolved

例子

比如我要关闭 123 号问题

可以使用close #123 或者 Closes: #123

上面的例子是关闭  同一个储存库的方式

如果你对于两个储存库都有权限,则可以使用

fix flutter/flutter#3283 这样的方式来关闭  这个问题

重复问题

除了上面的关键字以外 还有另一个关键字可以用于关闭 当然原则上来讲只限于重复的提交

Duplicate of 关键字

比如 你网络出现了问题 提交了 3 个相同的 issue ,分别是#1 #2 #3

则仓库所有者发现后可以在#2 #3其中分别回复Duplicate of #1来直接关闭 2 和 3