这一篇文章将主要介绍如何利用issue,merge等功能实现协作。
首先介绍如何使用issue。issue的机制可以看作一个任务管理系统,可以用来管理任务、待优化的地方、bug、讨论。
新建 Issues:
在任意库页面内点南 Issues 标签,再点击右侧绿色的 New Issuse 按钮进入新建 Issues 页面:
Title ~ 一句话描述主题,就像邮件标题一样,要直击要害。
Description ~ 正文,如有必要围绕主题补充细节,自动以 Markdown 格式标记,不过主题已经足够清晰的话,这里留白也无妨。
Labels ~ 标签方便日后分类管理内容和查找,比如标记 bug/docs/question/……设立标签要根据具体内容而定,比如阳老提到的文本类的 bug 要加个 content 标签,那么这个 issue 就需要 bug 和 content 两个标签(甚至更多)。
Milestone ~ 重要的时间或进度节点,比如 Launch OpenMindClub v 2.0)。
Assignee ~ 需要参与的成员,像 worktile 里的任务分配。
Comment ~ 建好 issue 后会出现在内容框下方,项目成员可以回复讨论。
重要原则:一次只说一件事,即一个 issue 对应一个主题。
填完以上内容这个 Issue 就建好了,项目成员还可以去修改(如果你看不到 Edit 按钮或是齿轮状的设置,可能是你没有这个权限,有需要可以让这个库的所有者为你开设权限),此时的 issue 状态为 open,接下来就等相关成员去讨论/解决。完成后 close issue,一个 issue 的使命就完成了,它的状态为 closed。
分支
协作的基础是分支,每个人在该项目中建立一个自己的分支
创建一个叫做"feature_x"的分支,并切换过去:
git checkout -b feature_x
切换回主分支:
git checkout master
再把新建的分支删掉:
git branch -d feature_x
除非你将分支推送到远端仓库,不然该分支就是 不为他人所见的:
git push origin <branch>
要合并其他分支到你的当前分支(例如 master),执行:
git merge <branch>
参考:
http://note.openmindclub.com/power/github-issue.html
http://www.ruanyifeng.com/blog/2014/06/git_remote.html
http://www.runoob.com/w3cnote/git-guide.html
https://bitmingw.com/2017/05/30/github-for-time-management/
网友评论