理系のための文書作成術(2) ―― 図表を表現手段として活用する

この連載では，ソフトウェア開発を例に，「どんな文書が開発を妨げるのか」，「分かりやすい開発文書を書くにはどうしたらよいのか」，「文書作成をどのように開発業務に組み入れていけば，品質と生産性が上がるのか」について考察する．今回は，「分かりやすい開発文書を書くにはどうしたらよいのか」に関して，特に図表の書き方に焦点を当ててみる．（編集部） 技術解説・連載「理系のための文書作成術」 記事一覧 第1回 開発文書を分かりやすく記述する 第2回 図表を表現手段として活用する 第3回 開発文書の書き方はしごとのやり方を示す 第4回 自分の「赤ペン先生」を持とう 第5回 設計レビューでするべきこと，してはいけないこと 第6回 仕事で文書を「書かされている」あなたへのメッセージ ●お知らせ 連載「理系のための文書作成術」が電子書籍になりました！ ご購入は「Tech Village 書庫＆販売」のページから．

[raitu]

同種の表では形式を統一する（比較が容易になる）・図には凡例を入れる・表は最左列を軸（ex:ID）とする・TBDとする場合、決定予定日を明記・各図表名は固有名詞にして区別がつくようにする・図表を付ける理由を明示す