「ドキュメント作成時」と題していますが、
どんなものを作るときも注意したいことです。
- 何をゴール（何がわかる・何ができる）とするものなのかを念頭に置いた上で、そこに向けて作成すること
- 何のためにこう書いているのかわからない、という点がないこと
-
記述ルールが統一されていること
- 半角と全角。特に数字や括弧、空白など
-
ブランクの記述ルール。空欄にするのか、「-」や「なし」と書くのか
- 空欄と「なし」が混在していたりすると、空欄箇所について誤って内容を削除したのか意図的なのか混乱する
- フォントサイズ
- 強調の仕方（フォントカラーや太字、マーキング）
- どの欄にどんな粒度の情報を書くのか
- ユーザ（読者）の理解度・知識を想定し、それに応じたレベルで記述すること
-
不要なものがないこと
- 無意味な罫線
- 古い情報・曖昧な情報は極力削除する。残すなら、TODOコメントなどによってステータスを明示しておく
フォントサイズ、マーキングのカラー、セル幅一つ一つに意味があります。
意図を持ってものをつくるのが大切です。
綺麗に作るために整えるのではなく、理解しやすくするために整えます。
自分のレベルと要求と納期のバランスも大事です。
上記に書いてあるようなことに気を配らなくていい場合もあります。そのときは、何故しなくてよいのかを自分自身が理解し、訊ねられてもすぐ答えられるようにします。
すぐすぐベストのものを作るのは難しいですが、
まずは気を付けてものを作る、それを繰り返したり少し時間が経ってから見直してまた直す……ということをやっていく内にスキルは身についてくると思います。（私もまだまだ）