設計、製造、ドキュメント
土曜日, 8月 31st, 2013システムのドキュメントは大事だと思っていたけど、ここ数年で考え方が変わってきた。
キッチリ書いたつもりでもコード修正すると合わない部分が出てくるので、細かいところはコードを読む、調べる足がかりになる概要のようなドキュメントを作ったほうが良いのではないか？ と思うようになってきた。
ファイル内のデータ構造とかは知りたいところで、細かく書かれるよりも例を載せられるなら例があったほうが理解が進む。
家の設計図を詳しく見たことはないけど、基本を建築士が作って、細かいところ… 釘とかホッチキスをどこに打ったりするかは現場で決めたりするのではないだろうか。
そこまで決まってたら建築業界スゲーけど。
