開発者向けのガイドライン

[kjmaeda]

お疲れ様です。
オープンソースサイトに開発者向けのガイドラインのページ(若しくはダウンロード可能なページ)が必要かと思います。
例えば
・機能追加マニュアル
・バグ改修マニュアル
・コーディング規約
・リリース手順
等・・・

ガイドラインがないと技術者は開発に着手できないと思います。
しっかりしたガイドラインがあるプロジェクトは、成果物の品質が良いです。
また、ガイドラインは今後有志が増えた時も作業管理がし易いです。

他に、開発者向けのガイドラインとして必要なドキュメントがあればこのスレに返信をお願いします。

[kjmaeda]

すみません。自分の考えを書き足させて下さい。
どんなガイドラインが必要なのか・・・僕の考えですが、それを洗い出す為には、
まずオープンソースプロジェクトに関わる登場人物(役割)を洗い出す事が大事です。
登場人物(役割)を洗い出して、その人達の作業マニュアルを作っていくことで、
自ずと必要なドキュメントを作ることができると思います。

[coke]

>一覧の項目ですが、管理対象の情報を検討した上で項目を決める方が宜しいのではないでしょうか。
了解しました
>管理番号、報告者、優先度、ステータス、標題
詳細情報という項目に、グーグルドキュメントへのリンクをはれるようにしました。

>安全面を考慮してvasdaqtelevisionではなく、更新担当者を決めて共同編集者に追加した方が宜しいかと思います。
担当が決まるまで、k.ma...さんを共同編集者に追加しておきます。

以上よろしくお願いします。

On 2009/09/22, at 17:06, k.ma... wrote:

TO:coke

お疲れ様です。k.ma...です。

>グローバルサイトのissueを、一旦非表示にしました。
>Wikiはがんばって活用しますが、issueは日本語版で、一旦管理していきましょう！

ですが、
日本語版のIssueですが、何点か検討したい所があります。

●故障一覧の項目について
一覧の項目ですが、管理対象の情報を検討した上で項目を決める方が宜しいのではないでしょうか。
内部でも故障管理をしているのですが、故障管理には少なくても以下の項目が必要です。
・故障番号
・報告者
・優先度
・ステータス　　 →★これが最も重要
・マイルストーン
・表題
・担当者
・故障内容
・問題原因
・対処方法

ただ、全ての項目をリストに表示すると情報が多くなった時に見づらくなってしまうので、
表示する項目、表示しない項目を区別したほうが良いかと思います。
個人的には、一覧に表示する項目は「管理番号、報告者、優先度、ステータス、標題」に表示して
表示しない項目は別ページやGoogleDocumentで管理して、一覧からリンクさせた方が
必要な情報が探しやすいと思います。

●運用方法について
日本語サイトのIssuesはオーナーか共同編集者しか編集ができません。
安全面を考慮して、発行したバグは一旦内部で管理し、精査したものから定期的に
サイトにアップする方法で運用するのが現状に適しているかと思います。

それとIssueを更新する際に使用するアカウントですが、
安全面を考慮してvasdaqtelevisionではなく、更新担当者を決めて共同編集者に追加した方が宜しいかと思います。

以上、ご検討の程よろしくお願いします。