GitHub 101

如果你有https://github.com/buhaochikuaigun/To-the-Moon的Developer权限,你可以直接在主分支上创作,但我们通常不建议这么做。如果有人同时和你编辑一个markdown文档,可能push时候会产生master分支上的合并冲突,需要额外的人力来revert上一个merge再考虑怎么合并两个更改。除非你会在短时间内(数小时内)更改,或者直接在GitHub上编辑,其余情况我不建议你这么做。

最好的方法是新建一个分支,把你想要更改的部分全部提交到这个分支上,push新的分支然后创建PR,其他有项目管理权限的人会帮助你合并分支。目前repo已经支持push到非主分支了。

# clone project
git clone <https://github.com/buhaochikuaigun/To-the-Moon.git>
# 创建分支
git checkout -b exmaple-task
# 确认更改的文件
git status
# 提交更改
git add <you change>
git commit -m "exmaple-task: Change something"
git push origin example-task
# 在GitHub页面会提示创建PR的按钮

Example PR:https://github.com/buhaochikuaigun/To-the-Moon/pull/1

Notion 101

我们用Notion作为工作流管理和新人onboard。

Untitled

当需要加新的内容的时候,你可以在未处理一栏创建一个新的ticket

Untitled

新的ticket包括标题(概括大概需要做什么),负责人(可以有多个负责人),ID(在git commit的时候前缀在commit message中,方便后续维护),分类,以及下面具体的实现方案。

示例Ticket: 这是一个标题(勿删

当你开始处理这个ticket的时候,可以把这个ticket拖拽到正在处理,这样大家就不会同时在做一件事情了。

完成后放到review,别的小伙伴可以去看看看看完成情况,如果没有要补充的就拖到处理完成,表示我们已经完成了这件事情。

Markdown Best Practice

[谷歌](<https://www.google.com>)
- 一级列表
	- 二级列表