改善此頁面

合併拉取請求

本指南適用於維護人員。這些特殊人士擁有對一個或多個 Jekyll 儲存庫的寫入權限，並協助合併他人的貢獻。您可能會發現這裡寫的內容很有趣，但這絕對不是適合所有人。

程式碼檢閱

所有拉取請求都應接受程式碼檢閱。程式碼檢閱是良好工程團隊的基本價值。除了驗證正確性外，它還能促進社群意識，並讓其他維護人員了解程式碼庫的所有部分。簡而言之，程式碼檢閱對於一個健康的開放原始碼專案至關重要。

合併前請閱讀我們的指南，了解如何檢閱拉取請求。值得注意的是，如果變更為程式碼，則必須經過測試，且至少要有兩位維護人員同意。

合併

我們有一個有用的機器人，我們用它來合併拉取請求。我們不使用 GitHub.com 介面，原因有兩個

  1. 您無法在行動裝置上修改任何內容（例如標題、標籤）
  2. 我們希望在每個版本的History.markdown 檔案中提供一致的紙本記錄

若要合併拉取請求，請留言感謝貢獻者，然後加入特殊合併請求

Thank you very much for your contribution. Folks like you make this project and community strong. :heart:

@jekyllbot: merge +dev

合併請求由三部分組成

  1. @jekyllbot: – 這是我們的機器人在處理指令時尋找的前綴
  2. merge – 指令
  3. +dev – 變更所屬的類別。

類別與History.markdown 檔案中的標題相符，它們是

  1. 重大增強功能 (+major) – 重大更新或程式碼中會中斷變更，需要重大版本升級 (v3 ~> v4)
  2. 次要增強功能 (+minor) – 次要更新（標籤為feature 或enhancement），需要次要版本升級 (v3.1 ~> v3.2)
  3. 錯誤修正 (+bug) – 不會變更或新增功能的程式碼修正，需要修補程式版本升級 (v3.1.0 ~> v3.1.1)
  4. 文件 (+doc) - 對docs/_docs/ 中文件所做的變更
  5. 網站增強 (+site) – 在 docs/ 中找到的 https://jekyll.dev.org.tw 來源變更
  6. 開發修正 (+dev) – 不會影響使用者介面功能或文件變更，例如修正測試或提升內部依賴項
  7. 前向移植 (+port) — 套用於先前版本 Jekyll 的錯誤修正，已拉取至 master，例如從 3-1-stable 到 master 的精選提交

一旦 @jekyllbot 合併拉取請求，您應該會看到三件事

  1. 成功合併
  2. 如果尚未套用，則新增必要的類別標籤
  3. 提交至 History.markdown 檔案，其中新增變更備註

如果您忘記類別，沒關係。您隨時可以返回並將該行移至正確的類別標題。類別對於 jekyll/jekyll 始終是必要的，但許多外掛程式變更太少，不需要變更記錄類別。

歡呼

您做到了！感謝您成為我們官方 Jekyll 專案的維護人員。您的工作對我們每天依賴 Jekyll 的數千名使用者來說意義重大。 :heart: