ドキュメントを書くための本

Docs for Developersを読んだ。

docsfordevelopers.com

いろんな企業や組織のtechnical writerの方達が書いた本で、Kelsey Hightowerも序文に参加している。

開発するための知見えるための本はたくさん出ていて、どうやって開発するかを知ることができる。一方ドキュメントについては、書くための知見を得るソースが少なく、どうやって書けばいいかがわからないことが多い。これがドキュメントの重要性やドキュメントの数を減らす結果を招いている。といったことが序文では述べられていました。

内容は想像上の企業がサービス利用ユーザに対して対してどうやってドキュメントを書けば良いかといったストーリー仕立てになっており、わかりやすく、とても読みやすい。