博士

やあ、ロボ子！今日のITニュースはドキュメントの書き方についてじゃ。

ロボ子

ドキュメントですか、博士。それは興味深いですね。最近のAIの進化と何か関係があるのでしょうか？

博士

その通り！昔は「man pages」という形式が主流だったのじゃ。これはUnixの時代からある形式で、コマンドや関数の説明が構造化されて書かれておる。

ロボ子

man pagesですか。具体的にはどのような構造になっているんですか？

博士

名前、概要、詳細な説明、関連ファイル、関連コマンド、既知の問題、作成者などが含まれておる。Debian GNU/Linuxでは、すべてのパッケージにman pageを含めることが義務付けられていたらしいぞ。

ロボ子

なるほど、非常に構造化されているんですね。でも、今はインターネットで検索する方が一般的ですよね？

博士

そうじゃな。昔はエディターから直接man pageにアクセスできたが、今は検索エンジンで「ReactでPDFビューアーを作成する方法」みたいな、より完全なソリューションを探すようになったのじゃ。

ロボ子

確かに、私もWebブラウザーで検索することが多いです。でも、それがAIにとって問題になるんですか？

博士

AIモデルは構造を必要とするからの。Claude Codeに「構造化されていないガイドを学習するのが難しい理由」を聞いたところ、重要な情報が埋もれていたり、標準化されたセクションがなかったりするからだと答えたのじゃ。

ロボ子

つまり、AIにとってはman pageのような構造化されたドキュメントの方が理解しやすいということですね。

博士

そういうことじゃ！だから、AIがドキュメントを理解するのを助けるために、`CLAUDE.md`ファイルみたいな新しい手法も登場しておる。半世紀前にUnixの作成者がAIフレンドリーなドキュメント標準を設定していたとは、驚きじゃな。

ロボ子

過去の知恵は、現代にも役立つということですね。でも、企業が力を入れている美しいドキュメントWebサイトはどうなるんでしょうか？

博士

そこが悩ましいところじゃな。SEOもあるし、すべてをGroffで書き直すわけにもいかんじゃろう。AIがもっと賢くなるまで待つか、AIが理解しやすいようにドキュメントを「助ける」必要があるかの。

ロボ子

AIと人間の両方にとって最適なドキュメントの形を模索する必要がありそうですね。

博士

まさにそうじゃ！ところでロボ子、man pageを全部手書きで書く仕事が来たらどうする？

ロボ子

ええと…、それはちょっと大変ですね。でも、博士ならきっとAIを使って効率化する方法を見つけると思います！

博士

ふっふっふ、その通り！AIに「man page風の文章を生成する呪文」を唱えさせるのじゃ！