ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング
ジャレッド・バーティ, ザッカリー・サラ・コーライセン, ジェン・ランボーン, デービッド・ヌーニェス, ハイディ・ウォーターハウス, and 岩瀬義昌
日本能率協会マネジメントセンター / 2023-03-11
この本について
プロダクトのドキュメントを書いていると、「これで本当に伝わるのか？」とか「自分には当たり前のことを、どこまで説明すべきなんだろう…」と手が止まることがよくあります。僕もまさにその沼にハマるタイプで、書いては直し、読み返しては迷う、をずっと繰り返してきました。 この本が助かったのは、悩んでいたポイントを “作業レベル” にまで分解してくれたところです。たとえば、フリクションログをつけて自分自身がユーザーとしてつまずく瞬間を拾う方法は、チーム内の「分かったつもり」を壊すのにかなり効きました。また、ハウツーとチュートリアルをどう分けるのか、どの段階で情報をどこまで載せるのかといった構造面の判断も、この本の考え方に沿うと迷いが減ります。さらに、ユーザーは基本的に流し読みしかしないという前提に立つことで、書き方そのものが変わっていきました。 派手なノウハウ本ではなく、現場で「これどうするんだっけ」と悩んだときのよりどころになる一冊です。ドキュメントの質を上げたいけれど、どこから手をつければいいのか迷っている人に特に刺さると思います。
読書インサイト
ハイライト密度
多くの読者は第3章に最もインサイトを感じており、全ハイライトの29%が集中しています。
読書の順序
この本の前に読まれた本
この本の後に読まれた本
先輩データサイエンティストからの指南書 -実務で生き抜くためのエンジニアリングスキル
浅野 純季, 木村 真也, 田中 冬馬, 武藤 克大, and 栁 泉穂
スタッフエンジニア マネジメントを超えるリーダーシップ
Will Larson, 長谷川 圭, and 増井 雄一郎
LangChainとLangGraphによるRAG・AIエージェント［実践］入門 エンジニア選書
西見 公宏, 吉田 真吾, and 大嶋 勇樹
サム・アルトマン：「生成AI」で世界を手にした起業家の野望
キーチ・ヘイギー and 櫻井祐子
AWS認定資格 ソリューションアーキテクト-アソシエイトの試験対策から学ぶ！超クラウド入門書【SAA-C03】: IT資格試験学習サイト「Ping-t」の最強WEB問題集を活用したインフラエンジニア登竜門資格の独学勉強法を徹底解説！ IT業界超入門書
ながたき
この本に似ている本
すべて見る arrow_right_alt
書籍情報（出版社紹介・目次）expand_more
出版社による紹介
読んだ内容を、もう忘れない。
BookNotion Zなら、Kindleのハイライトを自動で保存・整理。Notionにエクスポートして、いつでも振り返れます。
クレジットカード不要