ドキュメント

詳細設計書に何を書くべきか?

詳細設計書の書き方については黙っていられないので、ちょっと意見を言わせてもらう。私も「詳しすぎる詳細設計書 - SiroKuro Page」で示されているようなコードと1対1に対応したような詳細設計書は、書くだけ無駄だと思っている。ただ、ちゃんとした詳細…

プログラム設計書に日本語で擬似コードを書いてはいけない

悪いプログラム設計書は、一言で言えば「プログラミング言語を日本語で書いたもの」です。変数の代入からif文の遷移まですべて日本語で書いてあります。こんなものを書くぐらいならプログラムに落とした方が早いし、間違いも減ります。 まったく同感。では、…