如何贡献代码

视频 by happypeter

• 访问 saberma/19wu，点 Fork

• 等 repo 建好了, clone 到本地 GITHUB_ID 替换成自己的 github 帐户名。

  git clone [email protected]:GITHUB_ID/19wu.git
  cd 19wu
  

• 把 saberma 的 repo 加为 remote, 并且 master 跟踪 saberma 的 master 分支

  # 把 saberma/19wu 加为 remote 并取名为 upstream
  git remote add upstream git://github.com/saberma/19wu.git 
  git fetch upstream
  git branch -u upstream/master
  git pull
  

• 需要加功能的时候，基于 saberma 的 master (以后可以会换成 development) 分支 的最新代码建立新的分支，可以用 issue 的 tag 和 id 来做名字 (下面以 feature/41-how-to-contribute 为例)。并 push 到自己 的 repo 中方便定时备份。

  git checkout master
  git pull
  git checkout -b feature/41-how-to-contribute
  git push -u origin feature/41-how-to-contribute
  

• 在 topic 分支上修改并提交，定时 push 到自己的 repo 中备份

  # vim/emacs/subl xxxx
  # ...
  # git add xxx
  # git commit
  # 保持提交原子，检验的标准就是能用一句话作为 commit message 把这次 commit 内容说清楚。
  # commit message 可以用 #xx 引用 issue number
  # 因为指定过一次 -u，现在不用再写一长串了
  git push
  

• (可选) 建议你开通 https://travis-ci.org/ (如何使用 Travis CI 对 fork 的 Repo 做持续集成测试)， 这样 每次 push 到 server，如果失败了会有邮件通知。当然本地也要做好测试。

• 觉得完成了，打开自己帐户下的 19wu，你会看到有个提示，你刚刚 push 了新的分支 feature/41-how-to-contribute， 直接点击 send pull request, 检查下修改过的 文件。添加说明，最好用 hash tag 引用你完成的ticket number

   Feature/41 how to contribute
   
   完成 #41
  

  如果各种原因，你没有看到那个提示框，那么在 branch 下拉列表中选中你的 feature/41-how-to-contribute，然后点上方的 pull request。

• 如果有人提出改进意见，或者测试不通过，或者自己需要修改，直接在 feature/41-how-to-contribute 上继续工作，并 push。新的 commits 会自动出 现在 Pull Request 的列表中。