A Day In The Life

とあるプログラマの備忘録

2005-10-26から1日間の記事一覧

文書を書くときに気をつけること

対象読者を常に意識すること。 →対象読者が読んでもわからないことは書かない。 ソースを読んだだけではわからない設計思想も書くこと。 →事実を書くだけでなく、その裏にあるなぜそうなったかまで書く。 図と説明のバランスをとること。 →図ばかりでも説明…