Go Wiki:貢獻
https://golang.com.tw/wiki 的內容託管在 go.googlesource.com/wiki 倉庫中,並映象到 https://github.com/golang/wiki。
這些內容由託管官方 Go 網站 https://golang.com.tw/ 的同一伺服器提供服務。伺服器的原始碼位於 go.googlesource.com/website 倉庫中。
報告問題
對於與現有內容相關的問題,首選的解決方法是傳送更改。
但是,如果您想新增新頁面,請首先在 Go 問題追蹤器中建立一個問題,並帶有 wiki: 字首以提議新增。清晰地說明為什麼內容不適合任何現有頁面。
由於 wiki 中頁面的重新命名可能會破壞外部連結,因此在重新命名或刪除任何 wiki 頁面之前,請先建立一個問題。
如果問題與內容提供服務有關,請建立一個 GitHub 問題。
分類問題
要解決與內容相關的問題,建議找出最熟悉相關內容的人或團隊。專案所有者頁面是一個很好的起點。
對於與內容提供服務相關的問題,請遵循與 x/website 問題類似的常規分類流程,並將其標記為 website。
更新內容
在進行更改之前,請確保熟悉官方貢獻指南中概述的程式碼審查流程。
傳送微不足道的更改
對於諸如修復拼寫錯誤和新增缺失連結之類的小更新,您可以使用 GitHub flow。像往常一樣在 GitHub 倉庫中進行編輯,並開啟一個 GitHub 拉取請求。
更多資訊請參見透過 GitHub 傳送更改。
傳送非微不足道的更改
對於較大的更改,請按照透過 Gerrit 傳送更改中提供的說明,透過 Gerrit 傳送您的更改。
wiki 內容的規範倉庫位於 go.googlesource.com/wiki。
$ git clone https://go.googlesource.com/wiki
審查和提交更改
與其他 Go 倉庫不同,wiki 倉庫的提交過程只需要 wiki 倉庫維護者組中任何一人給出一個 +2。有關更多背景資訊,請參閱 提案 61940。
審閱者須知:一旦您給出 +2 並且所有評論都已解決,請儘快合併更改以避免合併衝突。
任何有興趣接收有關即將到來的 wiki CLs 通知的人都可以透過其 Gerrit 通知選擇加入。
更改和測試內容提供服務的行為
golang.org/x/website/cmd/golangorg 是提供 wiki 頁面的程式。
$ git clone https://go.googlesource.com/website
$ cd website/cmd/golangorg
遵循 README.md 中的說明在本地執行和測試程式。
此內容是 Go Wiki 的一部分。