エンジニアのためのドキュメントライティング
著 : ジャレッド・バーティ (Jared Bhatti)、ザッカリー・サラ・コーライセン (Zachary Sarah Corleissen)、ジェン・ランボーン (Jen Lambourne)、デービッド・ヌーニェス (David Nunez)、ハイディ・ウォーターハウス (Heidi Waterhouse)
効果的な開発者向けのドキュメントがあれば、問題発生時にも短時間で解決できる → 開発者向けドキュメントは重要
1 部 ドキュメント作成の準備
1 章 読み手の理解
「相手は必要な情報を知っているだろう」 という知識の呪いという認知バイアスから逃れてユーザーを理解するには?
ユーザーの最初のスケッチを作る : ユーザーが誰で、何を達成したいのか?
ユーザーのゴールを定義する
ユーザーがドキュメントを読んで達成したいこと
ユーザーを理解する
ユーザーニーズのアウトラインを作る
ユーザーの理解を検証する
既存の情報リソースを使う
対象ユーザーと既に繋がっているデベロッパーリレーションやマーケティングなどのチームを頼ったり、サポートチケットを確認したり
#書籍 #文献