ドキュメントを書く時に気をつけるポイント
概要は抽象的に
仕様は効果
技術わからない人にも伝わるような内容
実装は詳細
技術者がわかればいい内容
計算する数字は、数値として書く
ex) 7時半 → 7:30
ドキュメント
を読んでいる時の視線が横に動かないこと
上から下、縦に動くだけにするのが大事
目が滑りにくい
ネストをうまく使うと、「その」などの指示語が消せる