プロジェクト

全般

プロフィール

Rule of Shared Repository (ja) » 履歴 » バージョン 5

Kousuke Ebihara, 2012-11-22 18:42

1 3 Kousuke Ebihara
h1. 共有リポジトリのルール
2 1 Kousuke Ebihara
3 1 Kousuke Ebihara
h2. 概要
4 1 Kousuke Ebihara
5 3 Kousuke Ebihara
このドキュメントは OpenPNE3 開発の共有リポジトリ扱うためのルールについて説明しています。
6 1 Kousuke Ebihara
7 3 Kousuke Ebihara
このドキュメントにおいて、「共有リポジトリ」とは  git://github.com/openpne/OpenPNE3.git を意味します。
8 1 Kousuke Ebihara
9 3 Kousuke Ebihara
共有リポジトリを扱う場合、すべての人はこのルールに従わなくてはなりません。
10 1 Kousuke Ebihara
11 5 Kousuke Ebihara
h2. 共有リポジトリに対する push 権限
12 1 Kousuke Ebihara
13 5 Kousuke Ebihara
以下に示す GitHub アカウントの所有者は、共有リポジトリに対する push 操作を実行することができます(2012 年 11 月 22 日現在)。
14 1 Kousuke Ebihara
15 1 Kousuke Ebihara
* "balibali":https://github.com/balibali
16 5 Kousuke Ebihara
* "ebihara":https://github.com/ebihara
17 5 Kousuke Ebihara
* "imamura623":https://github.com/imamura623
18 5 Kousuke Ebihara
* "kashiwasan":https://github.com/kashiwasan
19 1 Kousuke Ebihara
* "kawahara":https://github.com/kawahara
20 5 Kousuke Ebihara
* "martini2002jp":https://github.com/martini2002jp
21 5 Kousuke Ebihara
* "niryuu":https://github.com/niryuu
22 5 Kousuke Ebihara
* "nise-nabe":https://github.com/nise-nabe
23 5 Kousuke Ebihara
* "ShinichiU":https://github.com/ShinichiU
24 5 Kousuke Ebihara
* "tejima":https://github.com/tejima
25 5 Kousuke Ebihara
* "touri":https://github.com/touri
26 5 Kousuke Ebihara
* "upsilon":https://github.com/upsilon
27 1 Kousuke Ebihara
28 5 Kousuke Ebihara
もしあなたが push 権限を得るに相応しいと思うのであれば、あなたの GitHub のアカウントを ebihara, balibali, ShinichiU のいずれかのユーザに連絡してください。
29 1 Kousuke Ebihara
30 1 Kousuke Ebihara
h2. コミット
31 1 Kousuke Ebihara
32 1 Kousuke Ebihara
h3. 直接のコミット
33 1 Kousuke Ebihara
34 1 Kousuke Ebihara
直接のコミットはいくつかの例外を除き認められません。
35 1 Kousuke Ebihara
36 1 Kousuke Ebihara
リリースマネージャーはリリース作業においては直接コミットをおこなうことができます。
37 1 Kousuke Ebihara
38 1 Kousuke Ebihara
それ以外の場合は、どんな人でも自身の clone において作業をしなくてはなりません。
39 1 Kousuke Ebihara
40 1 Kousuke Ebihara
h3. コミットメッセージ
41 1 Kousuke Ebihara
42 1 Kousuke Ebihara
マージの際、コミットメッセージは以下のルールに従っているようになっていなければなりません。
43 1 Kousuke Ebihara
* メッセージは必ず英語で記載してください。メッセージは他の言語を含むこともできますが、その場合は英語で説明をしなければなりません。
44 1 Kousuke Ebihara
* メッセージは関連するチケットの ID を含んでください。 ID は 「refs」や「fixes」というキーワードを伴って指定してください。これを守るための有用なフックスクリプトを用意してあります: http://gist.github.com/202866
45 1 Kousuke Ebihara
   例)  "Added ability to delete member from the mobile_backend application (refs #1)", "Added ability to configure gadgets from the mobile_backend application. Adding support to manage SNS from mobile is now completed. (fixes #1)"
46 1 Kousuke Ebihara
* メッセージは必ずそのコミットが何であるかの説明となるようにしてください。
47 1 Kousuke Ebihara
48 1 Kousuke Ebihara
このルールに従わないコミットは、たいていの場合拒絶されるでしょう。
49 1 Kousuke Ebihara
50 1 Kousuke Ebihara
h2. マージ
51 1 Kousuke Ebihara
52 1 Kousuke Ebihara
何かを開発した場合や Pull Request を受けた場合、マージをおこなってください。マージの後、変更を確認し、その変更に何かしらの欠陥があった場合、作者に連絡して修正をしてください。
53 1 Kousuke Ebihara
54 3 Kousuke Ebihara
変更が問題ないと思われる場合、共有リポジトリに push し、関連するチケットのステータスを「レビュー待ち」にしてください(コミットメッセージが fixes キーワードによってチケットと関連づけられている場合、ステータスの変更は自動的におこなわれます)。
55 4 Kousuke Ebihara
56 4 Kousuke Ebihara
h2. ブランチ
57 4 Kousuke Ebihara
58 4 Kousuke Ebihara
共有リポジトリでは、利用者の利便性を考慮して、ブランチをリリースブランチ (master 含む) に限定するべきです。作業用のブランチを push してはなりません。作業用のブランチは自分のリポジトリで作成してください。