emacs jpのリポジトリに関するガイドライン

リポジトリ作成

• emacs-jp organizationには原則メンテナンスが必要なパッケージのリポジトリのみを作成する
• 新しいパッケージについては emacs-jpでなく個人のスペースに作成する
• MELPA, el-getは同期が面倒になるので、ここに作らず、必要あれば個人のスペースに forkする

メンテナンスするパッケージを決定するまでの流れ

1. emacs-jp.github.comの issuesで提案する
2. メンテナンスする必要があるか、代替できるものがあるかなどについて議論する
3. メンテナンスすると判断した場合、何を行うべきかを議論する
4. 管理者権限を持つユーザにリポジトリを作成してもらう
5. (必要あれば)そのリポジトリのチームを作成する

メンテナンスを行うパッケージの開発の流れ

• 前の議論で出た修正すべき点をリポジトリの issuesにすべて記載する
• アクションを起こす際は必ず issuesを確認する。新規開発以外については issueベースで作業を行う
• コミットログには原則 issue番号を含め, どの問題と関連づいた修正かを明確にする
• 大規模な修正・新規コードの追加、自信のないコミット、意見を求めたい修正については pull requestを行う
• 自明な修正、READMEの修正等については直接 masterに pushすることを許可する

MELPA, el-get登録までの流れ

• 事前の議論で出た issuesをすべて消化する
• テストがあれば、テストが通ることを確認する
• (Emacsは性質上厳密にテストをすることが難しいので)数人に利用してもらい問題がないことを確認する
• MELPA, el-getに pull requestを行う