質問: 現場やプロジェクトによって詳細設計書の書き方は違ってくるとは思いますが、書き方のコツやアドバイスをお願いしたいです。
回答: 階層化、オブジェクト化、ファイル分割など何かしらの部品に分割しますが、その分割単位でどの様な役割なのかを日本語で書いておくのが良いと思います。1人でコーディングしているうちは良いですが、他の人が触る時に違う機能を混ぜ込んでしまう事があります。 (すべての関数毎に役割を書くのはあまりお勧めしません、あくまで日本語で説明できる範囲内が良いです。「変数xxxが値正常値てある事をチェックする」と言ったコードを見たら分かる事は書く必要がありません。) 後は業界毎のルールに従う必要はあります。