アカウント名:
パスワード:
DB設計書とか通信インタフェースとかUIとか色々ありますからね。ソースコードのコメントで表現が難しい/できなのも多いのでは。
> しかし、自動出力したドキュメントは「上司がわからないから」として却下された。
これもメソッドやクラスの(javadoc的な)物であればコードに触れない層にわからないだろうし、もっと上流の業務寄りな文書って必要だと思う。
DB 設計書って言っても、Excel の表にフィールド並べて1行コメントしてあるだけってレベルの多いしそのレベルで問題ないなら SQL にコメント入れとけば十分だって
そういうのは普通テーブルデザイナーツール使ってSQLとテーブル仕様書を自動生成するとコメントつきのSQLとExcelと生成してくれるでしょ
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
長期的な見通しやビジョンはあえて持たないようにしてる -- Linus Torvalds
設計書と一言で言っても (スコア:3, 興味深い)
DB設計書とか通信インタフェースとかUIとか色々ありますからね。ソースコードのコメントで表現が難しい/できなのも多いのでは。
> しかし、自動出力したドキュメントは「上司がわからないから」として却下された。
これもメソッドやクラスの(javadoc的な)物であればコードに触れない層にわからないだろうし、もっと上流の業務寄りな文書って必要だと思う。
Re: (スコア:0)
DB 設計書って言っても、
Excel の表にフィールド並べて1行コメントしてあるだけってレベルの多いし
そのレベルで問題ないなら SQL にコメント入れとけば十分だって
Re:設計書と一言で言っても (スコア:0)
そういうのは普通テーブルデザイナーツール使ってSQLとテーブル仕様書を自動生成するとコメントつきのSQLとExcelと生成してくれるでしょ