GitHubの使い方ガイド

[onion797jp]

GitHubの使い方ガイド・運用ポリシーがあるとコントリビュートしやすくなると思うので、おすすめな方法がありましたら、こちらにご紹介頂けたらと思います。こんな感じで作法は色々あると思うのですが、いくつかご紹介いただけますと運営の促進になるかと思いissue化いたしました。

ここである程度固まったらファイル化してみなさんと共有すると、今後進めやすいかと思います。

• issueのテンプレートサンプルを作って議論を提案しやすく
• projectを作成しmilestoneを設定して人をアサイン
• 作業用のbranchを作ってからプルリクエストを出す
• レビュー後に承認しmasterブランチにマージする

などの一連の流れをわかりやすくすることで、誰がどんなタイミングで何をするのかをイメージできるので、協議会を一つのプロジェクトとして管理しやすくなるとおもいます。

賛成あるいはここまでしなくてもよい、という意見もあると思います。皆様のお知恵を拝借できる場としてissueを活用してゆけたら良いと考えます。

[grvti]

issueのテンプレートサンプルについてですが、必ず含める内容として、以下のようなものはどうでしょうか。

issueタイトル：[議題]
issue内容：

1. 付与を望むラベルの種別
2. issueの対象はなにか（ある場合は参照先のリンクを含めて）
3. issueを立てて　なにがやりたいか/なにを目的とするか（簡潔に）

議題に関しては、質問や既存のドキュメントに対する意見などの場合は最後に疑問符を付けるようにします。上記のテンプレートをベースとして、issueする人が付与を望むラベルの種別によってテンプレートのサンプルを別途用意するというのはいかがでしょうか。見当違いであればすみません。

追記
でもやっぱり、タイトル長くなっちゃうかもしれないので、疑問符は推奨するだけでいいかもしれません。