実践!システムドキュメント徹底活用―設計・構築からテスト・運用まで (ネクストエンジニアSELECTION)
実践!システムドキュメント徹底活用―設計・構築からテスト・運用まで (ネクストエンジニアSELECTION)
翔泳社 翔泳社
￥ 2,310
実践!コミュニケーションドキュメント徹底活用 (ネクストエンジニアSELECTION)
システム構築のための4つの設計-設計の基礎知識と現場で活かせる51の鉄則
エンジニアのためのWord再入門講座 美しくメンテナンス性の高い開発ドキュメントの作り方
開発の現場 Vol.003 効率UP&スキルUP エンジニアのための実践ソフトウェア技術誌
開発の現場 vol.007 (開発の現場)
■いまいち。 評価1 日付2005-02-19
P58、「トヨタの5W(5回のWhy)で設計書を考えよう」と自分で言いつつ、「誰が」「いつ」「何を」「どう」という一般の5W1Hでリストアップしている。
他にも抽象論と具体論のバランスが悪いし、話の粒度が揃っていない（本書で紹介されている言葉を使えばパラレリズムが合っていない）。筆者のドキュメント作成能力に疑問を感じる。
例えばP70からP73。
(3)「転記を減らす」は2/3ページで終わり、
(4)「変更しやすく」では3ページ使い、「ドキュメントの変更のしやすさ」と「変更作業のしやすさ」に分けて、Excel の画面イメージ付でシートは分割しない方が一元管理できていいなんて書いてあったり、変更するならテーブル定義書参照ね、とテーブル定義書のサンプルがでかでかと載せている。
そもそも(4)を２項目に分けているにも関わらずそれが小見出しや箇条書きになっていないし、２項目に分ける意味も感じられない。シート分割するなってのもエンジニアなら One Fact in One Place なんて常識だし、変更時にテーブル定義書を参照すればいいって、それで十分だという保証はどう取るというのだろう。
さらに現場で使われる言葉を選ぶなら変更性でなく保守性だ。
(4)で中身のないことにページを裂くなら、(3)でセル参照やマクロを用いた自動転記を紹介しないのは何故だろう。それこそドキュメントを標準化することによる恩恵だというのに。
…と、いうようにツッコミどころ満載。
一般的なドキュメンテーションに関する本や実践性の高い Excel 本、トヨタ生産方式のホワイトカラー適用指南書を選んだ方がよい。
■具体例も不足 評価1 日付2004-12-03
著者に文章力・構成力があるのか疑問を感じた。
例えば、「SEのための文章力基礎講座」なる章があるが、その中に「データシミュレーションのススメ」というテストの一種の紹介を、中途半端な内容でなぜ含めたかわからなかった。
また、10ページ最後に「・・・その答えは・・・」の前後のつながりと文の表現が私には不自然に感じた。
その他、「付加価値」という表現が誰が何を基準としてのものかはっきりせず、「付加価値は『プログラム開発のみである』ことを自覚すること」とはどういうことなのだろうか。要求定義、分析、設計には、著者の「付加価値」がないのだろうか。
著者自身が、「文書力の３つのポイント」として著していることと矛盾する表現が多い。
例えば、「自動化（ニンベンのある自動化）」という表現の「（ニンベンのある自動化）」の意味はわからなかった。
「レビュー」の意味についても著者の世界での話となっている。
全般的に、著者のかなり偏った知識でもって記述されている。
特に開発工程に関しての説明・表現は不適切で、さらに著者自身の考え方が古い
（著者が著したかったであろう開発工程自体が古いという意味ではない）。
開発工程の各段階で必要となるドキュメントの理想的な記述項目やフォーマットを著したものでもないし、「模倣」する「システムドキュメント」の種類はほんの少数しかなく、「徹底活用」するには無理がある。
著者の部下向けに書かれた書物であろうか。
■徹底活用という主旨とは違いますが使える本です。 評価4 日付2004-03-20
個人的かも知れませんが徹底活用と言われると“外部設計書を運用マニュアルに簡単にシフトできる書き方”とか“外部設計書をそのまま結合テスト計画書に引用できる書き方”なんてものを想像して本書を購入しましたが「ドキュメントの標準化」をベースにかかれている本です。
「有効なドキュメント標準化のしくみ」を持たないシステム関連の企業や部門が標準化を考えるにはかなり具体的でわかりやすいと思います。機能分類（GUI、バッチなど）ごとに用意する設計書を変えるところなどはきっちり納得がいきました。
結構お勧めだと思います。タイトルと内容が違うと感じたので星４つです
⇒ もっと詳しく調べる