エピソード 11それで、私はドキュメント作成をしていました。私が行うことはすべて自己ドキュメント化されるため、これが貴重な時間の無駄であることは私たち全員が知っていますが、そこに上司が入ってきました。
「書類作成の進捗はどうですか？」と彼は人事整理簿の長いリストを見ながら尋ねた。
「あなたが部屋に入った瞬間に止まりました。」
「まあ、あなたがそれを理解しているかどうかを確認したいだけです。」
「私が存在するということを知って、あなたは安らかに眠ることができるでしょう。」
「そして、終わったら私にそれを見せてください。私たちが同じ認識を持っていることを確認するためです。」
ボスが目次ページを通過できるかどうかは疑問ですが、確認する必要があります。
「これは技術文書だということはご存知ですよね？」
"はい。"
「技術者向けに作られたものですか？」
「ああ」
「万が一、私がバスの前に飛び出してしまった場合に、私の役割を引き継ぐ人たち。おそらく、PFYが主導することになるのでしょうか？」
"はい。"
「…いずれにせよ、ドキュメントを必要としない人はいないでしょう。」
「はい、あなたの言いたいことは？」
「これは技術的な詳細について長々と説明しない技術文書です。」
"そして？"
「だから私は、手綱を取らなければならない人、手綱を取らなければならない人を雇用する人、あるいは、人々が手綱を取れるように馬糞をどかす人のために文書を書くのです。」
「それで、あなたは私がどちらであると思いますか？」
お答えするのは避けますが、作業中は手袋を着用することをお勧めします。ドキュメントに関しては、私が理解できる言語は3つだけです。技術系、平易な英語、そして簡単な英語です。技術的な内容が少ないほど、ドキュメントは長くなる傾向があります…
「それで、私が何言語で読んでいると思いますか？」
「私にメールを送るときに使うのと同じ言語です」と私は言い逃れるように言いました。
「どれですか？」
「私宛てのメールがどれくらい長いか気づいたことはありますか？」と私は尋ねます。「そして、私からの返信はどれくらい長くなる傾向がありますか？」
あ、そう言ったよ。
「それで、どの言語のことですか？」
はい、分かりやすい英語で言いました。
「バカ」と私は言う。
「何だって？！」ボスは怒り狂う。
「でも大丈夫だよ」と私は説明した。「技術マニュアルは技術者向けだからね。理解するだけの洞察力のない読者向けじゃないんだ。結び目理論の教科書を開いて、そこに書かれている数式を理解できるなんて思わないだろう？」
「そうでもないと思うよ」と彼は渋々認めた。
「そして同様に、ドメイン同期、仮想マシンの調整、さらには暗号キーの操作のニュアンスを理解することは期待できません。」
「確かにそうだな」と彼はため息をつき、私の肩越しに覗き込んだ。「今、何について書いてるんだ？」
「ランチタイムに美味しいオニオンバジを食べる方法」
"ごめん？"
「オニオンバジ。一番美味しいバジを食べるには、最初のバジが出てくるまで待つ必要があります。おそらく、前回メニューに載っていたバジを温め直したものでしょう。とはいえ、出来立てのバジが補充される頃には列に並んでいる必要があります。理想的には、最初のバジの3分の1くらいが皿に盛られた時に6人ほど並んでいると、ちょうど出来立てのバジが出てくるのでおすすめです。」
「これと技術文書と一体何の関係があるんだ？」
「これは IT プロフェッショナル向けのドキュメントです。私たちはランチが好きなのです。」
「それは私が理解できないことですよね？」
「あなたはいつも最初のバッチから食べるのよ」と私は指摘した。「はい。」
「このドキュメントは食事に関するものだけではないはずです！」
「私の役割のあらゆる側面をカバーしなければならないと言ったでしょう！」
「それで、今朝私が来たとき、あなたは何をしていましたか？」
「パブに行くタイミングを計って、新鮮な樽から10パイント目を飲むようにしましょう。」
"何？"
「技術的な話だよ！」と私は言った。「君には分からないだろうね。デイブが樽の交換係だから、彼がバーを10分以上離れている時――トイレにも行ってない時――樽を交換しているんだ。それまでは飲まない方がいいよ。ラガーとラインクリーナーを薄めたものが多いからね。だからPFYと僕は、君たちが何パイントか飲むまでは瓶ビールを飲んでいるんだよ」
"何？"
「技術的なことだって言ったでしょ」
「あなたが話していたドメインのことはどうですか？」
「マニアックなことって？そんなのマニュアルに載ってるんだから、わざわざ作り直す必要はない。いや、私が文書化しているのは、ITシステムの円滑な運用に不可欠な重要なことだ。君が尋ねたようにね。24時間年中無休で営業していて、幽霊会社のレターヘッドで『事務用品』の領収書を喜んで書いてくれるピザ屋はどこだろう？月曜日の朝に建物内の時計を全部20分戻し、午後遅くに40分進める方法。回転窓のロックを調整して、誰かが寄りかかった瞬間に窓が開くようにする方法。
「そんな事はないよ」
「もちろんです。エレベーターの加速・減速カーブを変えたり、売掛金担当のうるさい女性に更年期障害だと思わせるためにエアコン1台の温度と湿度の設定を20分間いじったり、ドアが開くのにどれくらい時間がかかるのか誰も正確に分からなくなってしまうようにマグロックの解放時間を少し長くしたり、などなど。
「それは役に立つ情報ではありません。」
「もちろんだよ。熱いコーヒーを持ちながら、どうしてドアにぶつかり続けるんだい？」
>スラム<
... 次の日...
ボスはドキュメント作成の件で機嫌が悪く、その結果、私たちの最新のサーバー プロジェクトを彼らの思い通りに進める目的で、IT セールス部門で働いていた頃のベテラン元同僚数人との会議に PFY と私を出席させることで罰しているのです...
予想通り、これは、過去 25 年間に作られたどのコンピューターよりもジンのボトルの底について詳しい 60 歳を超えるセールスマンによる、30 年以上も前の戦争物語のコレクションです。
「...でも、どうせログインの仕方を知らなかったんだから、関係なかったよ！」と、他のメンバーを面白がらせるために、1人が思わず口走った。
「すごいね」とPFYは言った。「君たちの話は素晴らしいね。僕もアルコール依存症の堕落者だったらよかったのに」
「さて」ボスは落ち着いた口調で言った。「あの頃は違う時代だったんだ」
「確かに、産業革命以降、多くのことが変化しました」とPFYは冷たく付け加えた。
公平に言えば、PFYの主張には一理ある。この会合は、21世紀に生きる人間というよりは、主要な政治指導者に見られるような、女性蔑視と人種差別が入り混じったものだった。
「とにかく」とボスは言った。「みんな、これから始まるこのプロジェクトについて聞いて興奮している。だから、概要を説明してもらえないか」
「どの部分を概説しますか。基本的な考え方ですか」と PFY は効果を出すために間を置いてから言います。「それとも技術的な詳細ですか?」
「技術的な詳細だ」ボスは怒り狂う。
「じゃあクレヨンを取りに行くわ」と言って、私は会議から少しの間、いや100分ほど離れた。
- BOFH: すべて
- BOFHアーカイブ95-99完全版
