Develop/guide
開発指針
- コーディングスタイル
インデントは4 tab / 4 shiftとする。その他のスタイルは既存のソースコードに準ずる。
なお、エンコーディングは UTF-8 を使用することとする。
- 外部設計
外部設計結果はJavadoc形式でソースコード内に直接記述する。package.htmlも活用する。
図などHTMLでは記述しにくいものについては、Office系ツールで記述し、doc配下に入れ、
ソースコードにはその参照先を記述する。
なお、ここで言う外部設計とは、例えばUDPReaderが受け付けるメッセージ形式や
外部アプリケーションから呼び出されるサービスの外部仕様などを指す。
- 内部設計/詳細設計
内部設計/詳細設計は「ソースコードがすべて」を原則とするが、アルゴリズムが複雑な場合など、
適時コメントで補足する事。
- メモ類
たとえば、開発環境のセットアップの方法など、外部の利用者も含め、みんなで共有すべきメモ類は、
Wikiを活用して、どんどん記述することに心がける。
- プロジェクト運営指針 / 開発指針
指針に類するものが、さまざまな文書に分散されると、プロジェクト運営上、良くない。
指針類は、Wikiを活用し、ひとまとめに記述することとする。