価値あるドキュメントを作るために／書評「エンジニアのためのドキュメントライティング」 - FURYU Tech Blog - フリュー株式会社

ピクトリンク事業部の橋本です。 『ユーザーの問題解決とプロダクトの成功を導くエンジニアのためのドキュメントライティング』を読んだので、今回はそのご紹介をさせていただきます。 ドキュメンテーションに対する考え方や評価基準などが学べたほか、重要性の再認識もでき、様々な収穫のある一冊でした。 この本を読むきっかけ どんな本？ 印象に残ったポイントまとめ イントロダクション PART1 ドキュメント作成の準備 PART2 ドキュメントの作成 PART3 ドキュメントの公開と運用 まとめ この本を読むきっかけ フリューでは長年にわたり、いくつものサービスを運営しています。 仕様書、設計、運用手順書、バグレポート、よくあるエラーとその対処法。その他もろもろのドキュメント類がサービスごとに存在しており、その総数は膨大な数にのぼります。 そして、たびたび 内容が古い。最新の手順に追随できていない(陳腐化)