回答編集履歴
1
ドキュメンテーションの必要性について追記
test
CHANGED
|
@@ -1,3 +1,15 @@
|
|
|
1
1
|
詳細設計書に何を書くか、なんの目的で書くかによりますが、私は詳細設計書はいらない派です。
|
|
2
2
|
|
|
3
3
|
詳細設計書を実装方法を設計するために、フローチャートやSPDを書くのであれば、それにかけるコストをどこかで回収できるとはとても思えません。いきなりコーディングしたほうが効率が良いです。また、そうでなければ、プログラマとしてどこか間違っています。
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
誤解を招きそうなので追記です。
|
|
10
|
+
|
|
11
|
+
ドキュメンテーションが不要であると言っているわけではありません。機能仕様書は必ず必要です。つまり、実装の内容はソースコードに記載されているので、ドキュメントは不要ですが、プログラムの外部仕様は文章で明らかにしておく必要があります。 また、機能仕様書は操作説明書、運用手順書、インタフェース仕様書などで代用できるのが理想的です。ユーザに仕様を説明すること=ソフトウェアを設計することであるべきです。
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
一般的に詳細設計書と呼ばれているものは実装の内容を記載するものなので、それはドキュメントとして切り離さずにソースコードの可読性をあげることで不要となるように努力すべきだと思います。
|