リポジトリへのcommit、issueへの追加のルール

[myuhe]

徐々に参加者も増えていってるように思いますので、そろそろ一定のルールを作っておいた方が良いのではないかと思いました。
commitについて整理すべき内容として

• commitの方法
  :ブランチを切るのか、とかmasterに直pushか とか
• issueとの関係
  : issueに対応するようにcommitしましょうとか。
• リポジトリ作成のルール
  : 新たにリポジトリ作るとかはどうすれば良いとか。

issueについては

• タイトルの命名ルール
  : どのようなタイトルにしましょう
• closeのタイミング
  : いつcloseするかとか、誰がcloseするのか、とか。
• ラベル
  : どれだけラベルを設定するか、とか

のようなものがあるかな、と思います。それとルールをどこに置いておくかとかですかね。

vim-jpでも、一定のルールがあるようです。
https://github.com/vim-jp/issues/wiki/Reporter
https://github.com/vim-jp/issues/wiki/Member

emacs-jpは、vim-jpにくらべ、裾野が広い感じがするので、もう少しルールがあってもいいのかな、と思いました。

[syohex]

リポジトリについて草稿を書いてみました

リポジトリ作成に関するガイドライン

[shishi]

「自明な修正」の範囲が人によって異なると思われますし、原則 Pull Request を経由すれば良いと思います。本当にすぐ分かるようなものならレビューに手間もかかりませんし。

[myuhe]

メンテナンス用リポジトリへのコメントは英語か日本語か、というのもありますね。migemoなどは恐らく日本人しか使わないでしょうから問題ないですが、elscreenなど定番のものは英語で書いておく方が良いかもしれないですね。

[syohex]

@shishi 若干草稿を修正しました。ご確認ください。

それについては意見があるかと思いますが、必要であればチーム単位で決めてもらえば
いいかと考えています。原則 pull requestという方針をチームで出したのならそうしていただければ
良いと考えます。

一つ懸念しているのはpull requestベースにすると放置されてしまう可能性があることです。
だいたいの参加者は社会人で忙しい中作業をされていることかと思います。
しかし忙しい時期になると見れない期間がしばらく続くというのも考えられます。
気分的に乗らずにしばらく作業を行いたくないこともあるでしょう。そうなったとき、
pull requestが放置されることが十分考えられます。

あと基本的にはそのリポジトリについては、emacs-jp全員でなくチームで責任をもってほしいと
考えています。全員が各問題をケアすることはリポジトリ数が増えると不可能になるのでしょう。
なので責任を持ってやって頂いた上で、masterに pushしてもらっても構わないと考えています。

[shishi]

なるほど。方針を理解しました。
チーム単位でルールを決めるならそれはそれで良いと思います！

[syohex]

issues作成に関するガイドラインの草稿を書きました

https://github.com/emacs-jp/emacs-jp.github.com/wiki/issue%E6%96%B0%E8%A6%8F%E4%BD%9C%E6%88%90%E3%81%AE%E3%82%AC%E3%82%A4%E3%83%89%E3%83%A9%E3%82%A4%E3%83%B3

[syohex]

リポジトリに関するガイドラインにコミットログについて追加しました

https://github.com/emacs-jp/emacs-jp.github.com/wiki/%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%AB%E9%96%A2%E3%81%99%E3%82%8B%E3%82%AC%E3%82%A4%E3%83%89%E3%83%A9%E3%82%A4%E3%83%B3

[znz]

pull request にする人に伝えたいことがあれば CONTRIBUTING.md を作っておくと良いみたいです。

https://github.com/blog/1184-contributing-guidelines