デービッド・ヌーニェスのレビュー一覧
-
4.3 (6) -
4.3 (6)
-
4.3 (6)
Posted by ブクログ
ユーザマニュアルの書き方の解説であるが、他の本と一味違うのは公開、フィードバック、メンテナンスまで扱っていること。ドキュメントは多くの場合、作りっぱなしになってしまうが、そうならないようにするにはどうすればよいかというところにまで配慮が行き届いている。作りっぱなしの問題はすでに起きているので対処法は非常に参考になった。また、ドキュメントの管理もプログラムと同様のバージョン管理システムを用いたりするなどプログラマの視点での解説となっており、プログラマとしては非常に理解しやすかった。そして、この解説自体が解説通りの書き方となっており、具体的のどうすればよいのか？にも答えている。ドキュメントの管理
-
4.3 (6)
-
4.3 (6)
Posted by ブクログ
エンジニアによるドキュメント作成（ユーザーガイド、運用手順書、APIリファレンス、設計書など）について、架空のプロジェクトを例にして順を追って解説されている。
ドキュメントの種類・書き方・考え方の概念的な方法論や教訓が、ある程度高いカバー率で網羅されている。基礎的な知識・原理を身につけることで長い目で見て役に立つ知識を得られるものであり、これを読んですぐにそのままマネすれば良い、というものではないと思う。
実務でエンジニアがやりがちな失敗や「考えが及んでいなかった」というケースへの言及が多く、経験者としては耳が痛いし、それゆえに学びが多い。
文量が多くて時間がかかりそうだったため、全体的に見出 -
4.3 (6)