「ドキュメントが読まれない理由」を短く整理すると、この記事では次の3点が分かります。
- 何の話か
- どういう仕組みか
- 最低限どこを押さえればいいか
この記事のテーマ
ドキュメントが読まれない理由
要点
問題点
- ドキュメントは作成者目線
- 読者の「今知りたいこと」に未対応
例え話
- 地図は現在地やルートが不明
- ドキュメントも「何が分かるか」が不明確
読者の状況
- 読者は忙しいため、即答が必要
- 作成者は知識が豊富で情報を省略しがち
解決策
- 読者の疑問に合わせた情報提供
- 読者が必要な情報を得られる構成が重要
まとめ
ドキュメントが読まれない理由は、細かく覚えるよりも全体像をつかめば十分です。
まずは要点だけ押さえておけばOKです。
動画で見たい方はこちら
- YouTube
YouTube でお気に入りの動画や音楽を楽しみ、オリジナルのコンテンツをアップロードして友だちや家族、世界中の人たちと共有しましょう。
www.youtube.com
