honda-jimusyo https://blog.hatena.ne.jp/honda-jimusyo/ つれづれなる技術屋日記 https://honda-jimusyo.com/ ソフトウェア 品質 最近、自分の資料作成や他人の文書レビューに参加して、ちょっとイライラ。自分や相手そのものへのイライラではなくて、文書がうまくまとまっていないとか、ロジックがおかしいと感じてのもの。「そういえば」と、とあるプロジェクトでの様子を思い出した。他のプロジェクトでも大なり小なり発生。むしろ、設計書作成や設計ドキュメントではイライラするくらいが正常と思うようになった。 どういう事かというと、ドキュメント作成時には、そもそもどうまとめるかで議論沸騰。章立てを決める前後は、どこに何を書いた方が良いか悩みが発生する。章立て（見出し）の階層レベルをどうするかも、キーポイントになる。しかも章立てしながら、新しい要… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fhonda-jimusyo.com%2Fentry%2F2012%2F12%2F16%2F234700" title="ドキュメント作成やレビューでのイライラ - つれづれなる技術屋日記" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2012-12-16 23:47:00 rich https://honda-jimusyo.com/entry/2012/12/16/234700 1.0 100%