經過之前的介紹,我們已經瞭解了 NG-ZORRO 很多內容,今天介紹該系列最後一篇文章:如何參與社群貢獻。在這篇文章中我們也會介紹如何進行 PR 提交
、CI 測試
、Merge 程式碼
等規範操作流程。
點選 fork
會自動在自己的倉庫生成一個同名倉庫,這樣我們就可以開始在自己的倉庫新分支進行開發,然後建立 PR 即可。
$ git clone https://github.com/{username}/ng-zorro-antd.git
$ cd ng-zorro-antd
// 新增一個遠端分支用於同步
$ git remote add upstream https://github.com/NG-ZORRO/ng-zorro-antd.git
$ git checkout -b my-fix-branch master
這樣就可以在本地分支修復或實現具體功能,注意 相關程式碼規範,當你完成了相關的修改後,只需要將自己的 commit
推送到自己倉庫的分支即可:
$ git commit -m "fix(module: xxx): xxx"
$ git push origin my-fix-branch
如果開發時間較長,有其他人已經推送了新的 commit 到 NG-ZORRO 的 master 分支,別忘了同步最新的分支程式碼喔:
$ git fetch upstream
$ git rebase -i upstream/master
這樣,在 github 建立一個 Pull Request 到 ng-zorro-antd:master
,官方機器人會自動幫助你打上 Labels
,Travis CI
工具也會自動跑,一旦所有的測試均已成功,社群值班同學也會進行程式碼 Review,最終全部通過後完成合並。
通常來說,NG-ZORRO 本週都會發一個小版本,用於修復社群使用者提出和發現的諸多問題,每個大版本內的釋出會保證程式碼相容,如 8.x 版本通常不會出現 break changes
,而是會在開發模式時在 瀏覽器 console
欄輸出 warning
資訊,以提醒使用者始終保持最新穩定版本,防止迭代版本差距過多導致後續升級困難。
至此,我們整個系列也告一段落了,當然,整個系列文章只涉及到了 NG-ZORRO 的一部分而已,更多的知識還是需要我們自己去使用嘗試發現。從專案第一個 commit
到現在,NG-ZORRO 已經有近百名參與者提供了 1100+ 個 commit
,更多的開發者也在不斷地加入,希望大家也能共同參與社群維護,這也是這個系列文章的一個重要目標。
也希望大家通過這些文章能瞭解到一些新的知識,對於我們文章中涉及的專案,如果後續有時間我也會繼續完善,並將相關資料文件以 markdown
格式檔案同步至 github 倉庫。