ツールを使ったドキュメント作成技法（前編） － ＠IT

特集：ツールを使ったドキュメント作成技法（前編） 価値のある開発ドキュメントを効率的に作成するには？ アバナード株式会社 市川 龍太（Microsoft MVP 2008 for XML） 2008/05/20 システム開発の現場では、さまざまなドキュメントを作成する必要がある。しかし昨今では開発の短期化に拍車がかかっており、ドキュメントを作成するための工数を十分に取れないことが多くなってきている。そこで本稿では、限られた工数の中で価値のある開発ドキュメントを効率的に作成するための技法について解説していく。 本題に入る前に、まずウォーターフォール型開発の各フェイズにおいて、一般的にどれだけのドキュメントを作成する必要があるのかについて以下の表にまとめてみた。

[steed5656]

ドキュメント化

[hiroponz]

Toolを使ってのドキュメント作成技法

[masakanou]

読む

[webmarksjp]

Agile

[tolll]

アジャイル・ドキュメント 1.必要十分 2.システムの一部 3.次の作業への備え 4.利点＞作成・保守コスト 5.信用しない 6.ニーズは異なる 7.なぜ必要か 8.投資 9.必要なときだけ作成 10.十分の判断は顧客

[nnn3]

C#のソースからAPIリファレンスを抽出するSandcastleというツールがある。知らなかった。

[bobbyjam99]

アジャイル・ドキュメントについて載っている．あと，効率的なドキュメントの書き方も載っている．