游諭 Swift Dev 🦄

新團隊建立 Git 指南 (一)

在 Git 團隊使用手冊中, 介紹了如何在多人團隊中建立 Git 的方式.

1. 耐心與同情心

有同情心的團隊會為新手留下說明操作程序的文件, 回答新人問題. "Help me, help you.", 就是專案領導人該有的口號!

目標: 一致性的部分都留下詳細的指引, 樣板及自動化腳本, 將標準之外的情況視為自己應該解決的程序問題.

推薦影片教學 https://player.oreilly.com/videos/9781491912003

2. 建立 Repository

不論選擇 GitHub/GitLab, 第一需要考慮的問題是: 該用哪個賬號建立 Repo? 首先, 在 repo 的 URL 通常會以 https://<代管系統主機>.com/<REPO擁有者>/, 端看這個專案(repo) 是屬於自己或是或是所屬的機構(公司), 選擇專案的擁有者.

第二, 決定專案各種權限: 對於開源專案, READ 的權限是開發的, 但對於 WRITE 的權限分成組織開發者, 非組織貢獻者. 對於這些分別的最大差別, 最主要的分別是: 可以同意寫入的能力, 例如一位非組織貢獻者想貢獻一部份的 code modification, 若使用的是 GitHub 服務, 則必須 fork 一份在自己賬號的複製專案, 推送改動, 並發起 Pull Request, 由組織開發者同意是否同意寫入.

3. 沒有寫入權限的專案成員對專案的貢獻步驟

  1. not folk
git colne REPOURL REPO
cd REPO
git remote add personal MYREPOURL
git branch my-proposal
git checkout my-proposal

# do all the concreate change

git add FILE
git commit -m 'finish change start porposal'
git push personal my-proposal

發起 Pull Request

  1. folk

在專案託管系統 folk 一份在自己賬號之下

git clone MYFORKURL REPO
cd REPO
git remote add REPOURL offical
git branch my-proposal
git checkout my-proposal

# do all the concreate change

git add FILE
git commit -m 'finish change start porposal'
git push original my-proposal

一樣發起 Pull Request

下一篇將介紹維護者要如何處理 Pull Request

Tagged with: