  |
今の日本だと誰がこんなマニュアルを読むんだ、読まないマニュアルなんて無駄という感じだろうが、このあたりが日本の弱いところではないだろうか。
こういうマニュアルを作る文化は軍から脈々と引き継がれていると思っていて、米軍の使命としてド素人を訓練しないといかず、マニュアルを作る。
日本だとマニュアル人間は嫌われる傾向があるが、マニュアル人間が大多数でも、柔軟にマニュアルが更新かけられれば問題ない。
ソフトの話に戻ると、何千ページもあるようなマニュアルでも、途中からプロジェクトに入ってきた人には全体像がわかるし、
マニュアルの1行1行を塗りつぶすようにテストコードを作っていく。
全部のテストが通るとマニュアルの文言も正しいことが保証される。
誰も読まないのだからマニュアルなんて作らずYouTubeで動画にすればいい、というが、動画にするのはこのマニュアルを読んだYouTuberにアウトソースすればいい。
スクリーンショットをペタペタ貼るのがダサいという風潮もあるだろうが、UIを変更する人もいるので、必要だ。
何千ページあろうが、（少なくとも顧客視点から）このドキュメントを読めばプロジェクト全体がわかるのがないと、全部を覚えている人などいないということになる。
日本は大規模かつ複雑なプロジェクトを放棄、大規模なドキュメントを作って残すこともしなくなっているように思うが、どうだろうか。
UIを変更する 文字しかないドキュメントを読んでて、 「〜のタブを選択する→一番下までスクロールする→そこに〜という項目があるやろ？」 ねーよ、だったりするよなぁ…
39
