Go Wiki: 貢献

https://go.dokyumento.jp/wiki のコンテンツは、go.googlesource.com/wiki リポジトリでホストされており、https://github.com/golang/wiki でもミラーされています。

これらのコンテンツは、公式Goウェブサイト https://go.dokyumento.jp/ をホストするのと同じサーバーによって提供されます。サーバーのソースは、go.googlesource.com/website リポジトリにあります。

問題の報告

既存のコンテンツに関連する問題については、変更を送信するのが望ましい解決方法です。

ただし、新しいページを追加する場合は、まずGo Issue Trackerに、プレフィックスwiki:を付けて問題をオープンし、追加を提案してください。コンテンツが既存のページに適合しない理由を明確に述べてください。

wikiのページの名前を変更すると、外部リンクが壊れる可能性があるため、wikiページの名前を変更または削除する前に、問題をオープンしてください。

問題がコンテンツの提供に関連する場合は、GitHub Issueをオープンしてください。

問題のトリアージ

コンテンツ関連の問題に対処するには、問題のコンテンツに最も詳しい人またはチームを特定することをお勧めします。良い出発点は、プロジェクトオーナーのページです。

コンテンツの提供に関連する問題については、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が1つだけ必要です。詳細については、提案61940を参照してください。

レビュアーへの注意:+2を付与し、すべてのコメントが解決されたら、マージの競合を避けるために、すぐに変更をマージしてください。

受信したwiki CLに関する通知を受信することに関心のある人は、Gerrit通知を通じてオプトインできます。

コンテンツの提供動作の変更とテスト

golang.org/x/website/cmd/golangorgは、wikiページを提供するプログラムです。

$ git clone https://go.googlesource.com/website
$ cd website/cmd/golangorg

プログラムをローカルで実行およびテストするには、README.mdの手順に従ってください。


このコンテンツは、Go Wikiの一部です。