@dmikurube
Dai MIKURUBE
6 years
作るもの・作ったものの設計をドキュメント化するときには、「なぜそうするか」「なぜこうはしないか」の理由と問題の背景、それを補助する実験・実測値が一番大事で、設計そのものの詳細を微に入り細に入り記述しておいてもドキュメントとして大して価値がない…、というのは定期的に言っていきたい
1
84
195

Replies

@dmikurube
Dai MIKURUBE
6 years
読み手にとって意外と役に立つのが「他にどういう設計の可能性があって、どうしてそれを選ばなかったのか」なので、これを考えて列挙して書くのは習慣化しておいていいと思う
0
18
54