アカウント名:
パスワード:
DB設計書とか通信インタフェースとかUIとか色々ありますからね。ソースコードのコメントで表現が難しい/できなのも多いのでは。
> しかし、自動出力したドキュメントは「上司がわからないから」として却下された。
これもメソッドやクラスの(javadoc的な)物であればコードに触れない層にわからないだろうし、もっと上流の業務寄りな文書って必要だと思う。
>もっと上流の業務寄りな文書って必要だと思う。
これだな。ソース読めば詳細はわかるけど、全体が見えない(見えるまで時間がかかる)全体像、設計思想、設計の意図、データフロー、業務フロー、入出力設計書、データ定義書ぐらいは必要。逆に、下流の「プログラム設計書」とか、正直いらんと思う。
#ソースコードとプログラム設計書(ソースコードと1対1に対応)渡されて、引き継ぎ終わり言われてもねぇ・・・
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
最初のバージョンは常に打ち捨てられる。
設計書と一言で言っても (スコア:3, 興味深い)
DB設計書とか通信インタフェースとかUIとか色々ありますからね。ソースコードのコメントで表現が難しい/できなのも多いのでは。
> しかし、自動出力したドキュメントは「上司がわからないから」として却下された。
これもメソッドやクラスの(javadoc的な)物であればコードに触れない層にわからないだろうし、もっと上流の業務寄りな文書って必要だと思う。
Re:設計書と一言で言っても (スコア:1)
>もっと上流の業務寄りな文書って必要だと思う。
これだな。
ソース読めば詳細はわかるけど、全体が見えない(見えるまで時間がかかる)
全体像、設計思想、設計の意図、データフロー、業務フロー、入出力設計書、データ定義書ぐらいは必要。
逆に、下流の「プログラム設計書」とか、正直いらんと思う。
#ソースコードとプログラム設計書(ソースコードと1対1に対応)渡されて、引き継ぎ終わり言われてもねぇ・・・