「プログラマーにドキュメントを書かせるには?」記事へのコメント

SQLのドキュメント

[yatakaras (37253)]

プログラマーとしてＳＱＬの補足にドキュメントを書きたいが、
いつも悩む。
・フローチャートじゃ表現できない
・ＤＴＤじゃアバウトすぎる（条件や、ソートまで書けない）

いまのところ、時間がある前提でドキュメントを書こうとすると
以下のようにしている。
・DTDでアバウトなIN/OUTのテーブルを記載
・ER図でテーブル結合の関係を記載
・表で取得データ書式（名前、型、サイズ、意味）
・条件を日本語で記載
・一応SQLのコメントも充実に

１枚で表現できる表現方法はないものか・・。

Re:SQLのドキュメント

[Anonymous Coward]

>１枚で表現できる表現方法はないものか・・。

それが結局 SQL そのものだったりする。

＃設計書に SQL がどーんと書いてあんの。