Go Wiki: ガーデニング
ガーデニングとは?¶
オープンソースプロジェクトにおける「ガーデニング」とは、プロジェクトを健全に保ち、成長させ、見栄えを良くするための、バックグラウンドで行われるメンテナンス作業のことです。
このページには、一般的な Go のガーデニングタスクがリストされています。
アクセス¶
Go コミュニティでしばらくの間、定期的に活動している場合は、Gerrit や GitHub へのアクセスをリクエストして、変更を加えることができます。
GerritAccess と GitHubAccess を参照してください。
ガーデニングタスク¶
ガーデニング作業、特にイシュートラッカーでの作業を行う前に、ここで説明されているイシューのライフサイクルをよく理解しておいてください: イシューの処理 - イシューの状態。
赤色の修正¶
https://build.golang.org/ を見てください。何か赤くなっていますか?修正するか、バグを報告するか、担当者に催促してください。ビルドダッシュボードは、たとえ一時的であっても、決して赤くなってはいけません。ツリーが赤色の場合、TryBots などが単に失敗を報告し、他の問題を隠してしまうため、人々は効果的に作業することができません。
新しいバグのトリアージ¶
トリアージされていないイシュー を見てください。Go では、特定のラベル (Needs*
または WaitingForInfo
) の有無を使用して、イシューがトリアージされているかどうかを示します。Go2
、Proposal
、CherryPickCandidate
、gopls
、pkgsite
のラベルが付いたイシューには、それぞれ個別のトリアージキューがあり、スキップできます。
バグのトリアージ中
- 重複していますか?重複を参照して、閉じます。
- バグではなく質問ですか?「Go に関する質問については、https://go.dokyumento.jp/wiki/Questions" を参照してください。」のように返信します。
- 件名は正しい形式ですか?パッケージパスとコロンで始める必要があります。「net/http: foo 操作中のサーバーのクラッシュを修正」のようにします。
- サブリポジトリにありますか?
http2
のようなリリースに入るサブリポジトリでない限り、マイルストーンはUnreleased
のままにしておきます。 - それが回帰であり、再現できる場合は、
git bisect
を使用して、問題のあるコミットを見つけます(オプションですが、非常に役立ちます)。 - 関連するパッケージには プライマリオwner がいますか?コメントでメンションしてください。いない場合は、
help wanted
ラベルを追加します。 - 関連するパッケージにオーナーがいないが、複雑で高度に技術的な性質を持っているように見える場合は、
ExpertNeeded
ラベルを追加します。
イシューがトリアージされたら、(イシューの処理 に従って) 適切なラベルを追加して、そのようにマークします。
WaitingForInfo¶
WaitingForInfo 状態のバグ (https://github.com/golang/go/labels/WaitingForInfo) を見つけて ping を送信し、返信が届いたらラベルを削除するか、返信が届かない場合はバグを閉じます。
「未計画」のバグ¶
「未計画」のイシュー は、放置される傾向があります。古いものをチェックして、簡単に修正できるかどうか(そして Go1.n または Go 1.nMaybe マイルストーンに移動できるかどうか)、または閉じる必要があるかどうかを確認します。
保留中の CL¶
コミットメッセージの形式、テストの有無、コードのフォーマット、受信した保留中の CL のタイプミス/文法を確認します。これらはすべて、変更自体の正しさを判断することなく行うことができます。保留中の CL のリストについては、https://dev.golang.org/release を参照してください。
+1 が付いたら、そのエリアのオーナーは +2 を付けることができます。
+1 は「トリアージ済み」または「明らかに間違っていない」という意味で読んでください。テストがあり、適切にフォーマットされ(バグ番号を参照している可能性が高い)、さらにレビューできる状態であれば、+1 を付けてください。
保留中の CL: テストについて質問する¶
テストがない新しい CL が到着したが、テストを追加できる/追加する必要がある場合は、テストを追加できるかどうかを質問してください。または、追加方法を提案してください。
保留中の CL: TryBots を実行する¶
TryBots を実行するためのアクセス権(GerritAccess を参照)があり、妥当な(悪意のない)コードを含む CL を見つけた場合は、TryBots を起動してください。(TryBot サンドボックスから悪意のあるコードがエスケープしようとしたことは一度もありませんが、まだ自動化されていないのはそのためです。何かを見つけた場合はお知らせください。)
このコンテンツは Go Wiki の一部です。