お久しぶりです。先日、皆様のおかげで大学を無事に卒業したなおぽんです！🐹
この度も読了した本をまとめました！

読んだ本

本書の内容

アプリケーションやAPIなど、それらのものを使用する人が正しく使えるように導くことがドキュメントの目的となります。

優れたドキュメントと呼ばれる書類には以下の3Cが大切のようです。

Clear (明確な)

定義がしっかりされており、読み手の不明瞭な点がないことです。例：
- 技術力がどの程度ある人向けのドキュメントなのかが明確である
- 何について書いてあるドキュメント、またはセクションなのかタイトルだけでわかる
- アプリケーションなどの使い方の手順が順番通りである

Concise (簡潔な)

不要な内容が含まれていないことです。
例：Ruby on Railsのnewコマンドの説明セクションに、Railsのインストール方法の話を入れない

Consistent (一貫した)

ドキュメントの構造が一貫していることです。
例：
- タイトルに沿ったセクションがある
- セクションの説明がある

優れたドキュメントの3Cを守りながらライティングを行うには、コードを書きながら並行して以下の方法で執筆することをおすすめだと記されていました。

また現時点で変更される予定があるコードには、注意を促しておくなどがありました。

ここまでお読みいただき誠にありがとうございました！🐹
個人的には周りくどい書き方が多いなと思いながら読みました笑　ですが、ドキュメントはアプリなどを使用する人が参考にする道標だから軽く見てはいけないということを伝えており、ドキュメントに対しての考えを改めたい方にはおすすめです。