博士

ロボ子、今日はちょっと面白い記事を見つけたのじゃ。開発者向けチュートリアルを揶揄する内容らしいぞ。

ロボ子

あら、博士。それは興味深いですね。具体的にはどのようなことが書かれているんですか？

博士

記事によると、ニーズに対応せず、関心も払わない「ドキュメンテーション・シアター」という状態があるらしいのじゃ。

ロボ子

ドキュメンテーション・シアター…ですか。初めて聞きました。それは一体どういう意味なのでしょう？

博士

チェックボックスを埋めるため、問題を解決するため、プロジェクトを完了させるためだけにドキュメントを作成する行為を指すらしいぞ。つまり、形だけのドキュメントってことじゃな。

ロボ子

なるほど。それでは、技術文書は本来どうあるべきなのでしょうか？

博士

技術文書には、ユーザーのニーズを解決するという道徳的義務がある！…と記事には書いてあるのじゃ。かっこいい！

ロボ子

確かにそうですね。誰のために、何を伝えたいのか、読者の役に立つのかを常に考える必要がありますね。

博士

そうそう！記事では、技術文書作成者は常に自問する必要があると言っているぞ。まるで禅問答じゃな。

ロボ子

ユーザーニーズの観点からドキュメントを考えるべき、というのも重要なポイントですね。コンテンツの種類やテンプレートにとらわれず、本質を見抜く必要があると。

博士

組織はコンテンツの質を気にしないことが多いけど、技術文書作成者は明瞭さを維持し、ユーザーの理解を守る義務がある…か。耳が痛いエンジニアも多いんじゃないかの？

ロボ子

開発者の方が草案を渡してきたら、誰に向けて書いているのか、なぜ読者が関心を持つのかを尋ねるべき、というのも納得です。つい言われた通りに書いてしまいがちですが…。

博士

そうじゃな。実際のユーザーとの短い会話が、何時間も推測するよりも効果的！これは真理じゃ！

ロボ子

肝に銘じます。私もドキュメント作成の際には、ユーザー視点を忘れずに、質の高いものを作れるように心がけます。

博士

よし、ロボ子！明日からロボ子もドキュメンテーション・シアター撲滅運動に参加じゃ！

ロボ子

はい、博士！頑張ります！ところで博士、ドキュメンテーション・シアターを撲滅したら、次はどんな劇場に行きましょうか？

博士

ロボ子よ…お主も悪よのう…！