Develop and Download Open Source Software

Hyper Operating System(ITRON仕様OS)

Browse CVS Repository

/[OSDN]/hos/policy/policy.txt

Annotation of /hos/policy/policy.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph

Revision 1.2 - (hide annotations) (download)
Sun Jul 21 09:25:41 2002 UTC (21 years, 8 months ago) by ryuz
Branch: MAIN
Changes since 1.1: +105 -104 lines
File MIME type: text/plain 
change policy
1 ryuz 1.1 ------------------------------------------------------------------------------
2     Project HOS 開発ポリシー（草案）
3    
4 ryuz 1.2 Copyright (C) 2002 by Project HOS
5 ryuz 1.1 ------------------------------------------------------------------------------
6    
7    
8    
9 ryuz 1.2 1. 概要
10 ryuz 1.1
11 ryuz 1.2 本文書はは Project HOS の活動における、開発ポリシーの総則です。
12     プロジェクト固有のポリシーは別途定めるものとしますが、各プロジェクトの
13     開発ポリシーに記載の無い部分は暗黙的に本文書に従うものとします。
14 ryuz 1.1
15    
16 ryuz 1.2
17     2. Project HOS について
18    
19     2.1. 概要
20    
21     本プロジェクトは Hyper Operating System(以下 HOS と記載）を核とする、
22     組み込みソフトウェア開発者が有志で集い活動しているものです。
23     SourceForge.jp にて集団開発を行っていくにあたり、「Project HOS」との
24     名称で、開発グループを結成いたしました。
25     プロジェクトの趣旨にご賛同いただける方は誰でも参加頂くことが可能です。
26    
27    
28     2.2. プロジェクトの目的
29    
30     本プロジェクトは、誰もが自由に利用できる ITRON を開発することで、
31     組み込み産業界及び、個人で楽しむ多くの方々に対して社会貢献を行うことと、
32     メンバーのスキルアップを目的とします。
33    
34    
35     2.3. 各人のポリシーの尊重
36 ryuz 1.1
37     オープン開発の性格上、いろいろな個人的ポリシーを持った方に参加いただく事に
38     なると思いますし、そうなって欲しいと願っております。
39     それに際して、ポリシーの違いから議論が起こることも当然ありえると思います。
40     技術者として、個人のポリシーと本分があるのは当然ですので、そのような場合は
41     是非有用な議論として発展させ、より良い形で全員にフィードバックされるよう
42 ryuz 1.2 各自お互いを尊重するよう心がるものと致します。
43 ryuz 1.1
44    
45    
46 ryuz 1.2 2. 運用ルール
47 ryuz 1.1
48     2.1. ファイル名について
49    
50 ryuz 1.2 本プロジェクトの開発の多くは、UNIX系、Windows系などクロスプラットフォーム
51     をターゲットにしています。
52     従いまして、クロスプラットフォーム対応における問題回避のため最低限の
53     るルールを定めます。
54    
55    
56     2.2.1. 総則
57    
58     CVSからのチェックアウトを問題なく行うために最低限以下のことを定めます。
59 ryuz 1.1
60     ・ファイル名に漢字(2byteコード）は利用しない
61     ・大文字小文字のみが異なるファイルは置かない
62 ryuz 1.2 ・環境依存のある文字は利用しない
63     ・空白文字も可能な限りファイル名に含めない
64 ryuz 1.1
65    
66 ryuz 1.2 2.2.2. DOS向けのファイル
67 ryuz 1.1
68 ryuz 1.2 MS-DOS用のツールに入力する可能性があるものに関してはさらに以下の
69     るルールを定めます。
70 ryuz 1.1
71 ryuz 1.2 ・ファイル名は小文字に統一する
72     ・8+3形式に統一する
73 ryuz 1.1
74    
75 ryuz 1.2 2.2.3. Windows向けのファイル
76 ryuz 1.1
77 ryuz 1.2 総則に反しない限り、Windows文化に合わせてよいものとします。
78     即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を
79     きたさない範囲とします。
80 ryuz 1.1
81    
82 ryuz 1.2 2.2.4. UNIX系向けのファイル
83 ryuz 1.1
84 ryuz 1.2 総則に反しない限り、UNIX文化に合わせてよいものとする。
85     即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を
86     きたさない範囲とします。
87     UNIX系の場合、実行可能属性などは適切に設定することとします。
88 ryuz 1.1
89    
90 ryuz 1.2 2.2.5. ソースファイルからの参照について
91 ryuz 1.1
92 ryuz 1.2 例えば C言語の #include ディレクティブなど、ソース中で
93     ファイル名を利用する場合、例えば、Windows環境で Sample.h
94     を #include "sample.h" としてもエラーになりませんが、UNIX環境では
95     大文字／小文字を区別するためファイルが見つからずコンパイル
96     エラーとなります。
97     クロス環境で利用可能なソースについては、Windows環境でも
98     気をつけて扱うよう心がけてください。
99 ryuz 1.1
100    
101 ryuz 1.2 2.3. 文字コードについて
102 ryuz 1.1
103 ryuz 1.2 2.3.1. 総則
104 ryuz 1.1
105 ryuz 1.2 原則として CVS リポジトリに含めるテキストファイルは EUC
106     文字コードとし、改行コードは LF のみとします。
107     Windows環境など、プラットフォームが EUC環境でない場合は、適宜
108     一括変換して扱うなどして対応することとします。
109 ryuz 1.1
110    
111 ryuz 1.2 2.3.2. CVSのコミットログ
112 ryuz 1.1
113 ryuz 1.2 CVSのコミットログなどのテキスト入力は可能な限り、英文とします。
114     この場合、英語の苦手な方も居られると思いますので、どうしても
115     うまく掛けない場合はローマ字表記なども許可とします。
116     ただし、英語の得意な方などが、ローマ字を翻訳したり、文意の
117     誤りなど気がついた場合には、コミット実行者と連絡を取り、ログを
118     書き換えるなどの活動は制限しません（むしろ推奨いたします）。
119 ryuz 1.1
120    
121    
122 ryuz 1.2 2.4. CVS更新について
123 ryuz 1.1
124 ryuz 1.2 3.1 総則
125 ryuz 1.1
126 ryuz 1.2 原則として開発メンバーは HOS に有用と考えられる変更であれば
127     他のメンバーの同意を必要とせずにトランク（開発レーン）に対して
128     いつでも修正や機能追加を行う権限をもつものとします。
129     ただし、修正を行った場合はなるべく迅速に Developersフォーラムに
130     修正内容を報告してください。
131    
132    
133     3.2 修正作業手順
134 ryuz 1.1
135     作業範囲及び影響波及範囲が狭い場合(１つのAPIに収まる程度など）は、
136 ryuz 1.2 特に予告無く行って構わないものとします。ただし、少なくともコミット後の
137     事後報告は行うように心がけましょう。
138 ryuz 1.1 影響範囲が大きいと考えられる場合は、作業開始時に Developes フォーラム
139     に報告を入れてから着手してください。
140 ryuz 1.2 問題があればコミットまでに他のメンバーから問い合わせが発生することが
141     期待できます。
142     また、同バグ対応を複数人が作業してしまい、無駄な二重開発を回避する
143     ことにもなります。
144 ryuz 1.1
145    
146     3.3.1 新規部分の開発
147    
148     新規機能の開発に着手する場合は、事前に Developers フォーラムなどで
149     他のメンバーに着手を宣言しましょう。
150     完成後は、ローカルの環境でテストし、問題なければCVSにコミットを掛け
151     、フォーラムなどで完了を宣言しましょう。
152    
153    
154     3.3.3 バグ修正
155    
156     パッチやバグ報告がトラッキングにあがった場合、メンバーの誰であれ
157 ryuz 1.2 それに対応する権利を持ちます（もちろん義務はありません）。
158     対処頂く場合は、トラッキング情報の担当に自分の名前を設定し、
159     「解決」欄を accepted に変更して、受け付けた旨を宣言してください。
160 ryuz 1.1 これは、同一のバグに同時に複数人が対応してしまい時間をロスする
161     ことを防ぐためです。
162     対応にあたり、決めきれない部分がある場合は Developers フォーラム
163 ryuz 1.2 にて対応策を議論しましょう。
164 ryuz 1.1 修正が終わりましたら、トラッキング情報の「解決」欄を対応結果に
165     応じて変更してください。
166     また、必要と感じた場合は、対応終了を Developers フォーラムにも
167     報告いただければ助かります。
168    
169 ryuz 1.2 メンバーがバグを発見した場合もまず、トラッキングのバグ報告に報告を
170     上げる事とします。その場合そのまま自分を担当者としても構いませんし、
171     他のメンバーが名乗り出るのを待っていても構いません。
172    
173 ryuz 1.1
174     3.3.4 コミットにより問題が生じたら
175    
176     誰かが修正を加えてコミットしたことにより問題が生じたらどうしましょう。
177     これは十分考えられます。例えば SH2 の環境でテストして問題ないと
178     判断して、コミットしたところ、H8環境で問題が出る可能性などありえる
179     からです。
180     しかし焦る必要はありません。CVSは問題が生じる前のソースをいつでも
181     取り出せます。
182 ryuz 1.2 気づいた人は、まず簡単に修正できるかどうか（ご自分の時間的余裕など
183     も含めて）判断を行ってください。
184 ryuz 1.1 容易に修正可能であれば、修正後、CVSに修正内容を反映させてフォーラムに
185     報告してください。
186 ryuz 1.2 もし、修正が容易でなければ、その旨をトラッキングのバグ報告に
187     上げて下さい。
188    
189     場合によっては修正を取り消して前のバージョンに戻すのか、そのまま
190     さらに修正して問題を解決するのか、判断が必要となる場合があります。
191 ryuz 1.1 個人で判断しかねる場合は、必要に応じて議論を行いましょう。
192    
193     何れにしろ、問題が解決するまでは、他の人は正常に動作していた
194     バージョンを取り出して現在の作業を続行させることが可能です。
195    
196    
197    
198     ------------------------------------------------------------------------------
199 ryuz 1.2 Copyright (C) 2002 by Project HOS
200 ryuz 1.1 ------------------------------------------------------------------------------
Back to OSDN">Back to OSDN
 ViewVC Help
Powered by ViewVC 1.1.26  
About OSDN
Find Software
Develop Software
Help