プロジェクト

全般

プロフィール

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

Kousuke Ebihara, 2010-05-07 15:12
ブランチについての記述を追加

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 1 Kousuke Ebihara
h2. Repository Collaborators
12 1 Kousuke Ebihara
13 3 Kousuke Ebihara
Repository collaborators は共有リポジトリを扱うことができます。
14 1 Kousuke Ebihara
15 2 Kousuke Ebihara
以下は現在の collaborators の一覧です(2010 年 5 月 7 日現在)。
16 1 Kousuke Ebihara
* "ebihara":https://github.com/ebihara
17 1 Kousuke Ebihara
* "balibali":https://github.com/balibali
18 1 Kousuke Ebihara
* "ShinichiU":https://github.com/ShinichiU
19 1 Kousuke Ebihara
* "fukamachi":https://github.com/fukamachi
20 1 Kousuke Ebihara
* "uzura8":https://github.com/uzura8
21 1 Kousuke Ebihara
* "nothan":https://github.com/nothan
22 1 Kousuke Ebihara
* "kawahara":https://github.com/kawahara
23 2 Kousuke Ebihara
* "yukikame":https://github.com/yukikame
24 1 Kousuke Ebihara
25 1 Kousuke Ebihara
もしあなたが repository collaborators に相応しいと思うのであれば、あなたの GitHub のアカウントを ebihara@tejimaya.com に教えてください。
26 1 Kousuke Ebihara
27 1 Kousuke Ebihara
h2. コミット
28 1 Kousuke Ebihara
29 1 Kousuke Ebihara
h3. 直接のコミット
30 1 Kousuke Ebihara
31 1 Kousuke Ebihara
直接のコミットはいくつかの例外を除き認められません。
32 1 Kousuke Ebihara
33 1 Kousuke Ebihara
リリースマネージャーはリリース作業においては直接コミットをおこなうことができます。
34 1 Kousuke Ebihara
35 1 Kousuke Ebihara
それ以外の場合は、どんな人でも自身の clone において作業をしなくてはなりません。
36 1 Kousuke Ebihara
37 1 Kousuke Ebihara
h3. コミットメッセージ
38 1 Kousuke Ebihara
39 1 Kousuke Ebihara
マージの際、コミットメッセージは以下のルールに従っているようになっていなければなりません。
40 1 Kousuke Ebihara
* メッセージは必ず英語で記載してください。メッセージは他の言語を含むこともできますが、その場合は英語で説明をしなければなりません。
41 1 Kousuke Ebihara
* メッセージは関連するチケットの ID を含んでください。 ID は 「refs」や「fixes」というキーワードを伴って指定してください。これを守るための有用なフックスクリプトを用意してあります: http://gist.github.com/202866
42 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)"
43 1 Kousuke Ebihara
* メッセージは必ずそのコミットが何であるかの説明となるようにしてください。
44 1 Kousuke Ebihara
45 1 Kousuke Ebihara
このルールに従わないコミットは、たいていの場合拒絶されるでしょう。
46 1 Kousuke Ebihara
47 1 Kousuke Ebihara
h2. マージ
48 1 Kousuke Ebihara
49 1 Kousuke Ebihara
何かを開発した場合や Pull Request を受けた場合、マージをおこなってください。マージの後、変更を確認し、その変更に何かしらの欠陥があった場合、作者に連絡して修正をしてください。
50 1 Kousuke Ebihara
51 3 Kousuke Ebihara
変更が問題ないと思われる場合、共有リポジトリに push し、関連するチケットのステータスを「レビュー待ち」にしてください(コミットメッセージが fixes キーワードによってチケットと関連づけられている場合、ステータスの変更は自動的におこなわれます)。
52 4 Kousuke Ebihara
53 4 Kousuke Ebihara
h2. ブランチ
54 4 Kousuke Ebihara
55 4 Kousuke Ebihara
共有リポジトリでは、利用者の利便性を考慮して、ブランチをリリースブランチ (master 含む) に限定するべきです。作業用のブランチを push してはなりません。作業用のブランチは自分のリポジトリで作成してください。