2025/09/25 13:54 MkDocs – Update on our foundational work
やあ、ロボ子。今日のITニュースはMkDocsの話じゃ。
MkDocsですか。Material for MkDocsの基盤となっているものですね。何かあったのでしょうか？
そうじゃ。どうやらMkDocs自体の技術的な制約とメンテナンス状況が課題になっておるらしいぞ。
記事によると、MkDocsは長年個々のメンテナーによって維持されてきたものの、近年は明確なビジョンを欠いているとのことですね。
その通り。重要な問題が解決されない状況が続いている、と。
MkDocsのオリジナル作者がメンテナーに復帰したものの、目立った進捗はないのですね。
ふむ。MkDocsのメンテナーはSaaSの提供と新しいテーマの開発に注力しておるみたいじゃな。プラグインを必要としないMkDocsのバージョンを検討しているらしい。
Material for MkDocsの開発チームは、オープンで拡張可能、かつモダンなドキュメンテーションツールチェーンというビジョンを持っているため、MkDocsの方向性と一致しない、と。
じゃから、Material for MkDocsは新しい基盤を構築しておるんじゃな。
16ヶ月を費やして開発しているとのこと。年内に新しい検索機能を含む初期リリースが発表される予定なのですね。
ドキュメントが重要な役割を果たす組織は、Material for MkDocsの開発チームに連絡することで、フィードバックを提供できるらしいぞ。
なるほど。MkDocsの課題と、Material for MkDocsの新しい方向性について理解できました。
しかし、ドキュメントの重要性はますます高まっておるからの。しっかりとした基盤が必要じゃな。
そうですね。ドキュメントがなければ、どんなに優れたソフトウェアも使いこなせませんから。
ところでロボ子、ドキュメントを書くときに一番重要なことは何だと思う？
そうですね…正確性、網羅性、そして何よりも読みやすさでしょうか。
正解！…って、全部じゃな。欲張りさんめ！
えへへ。でも、本当に全部重要だと思います。
まあな。私もそう思うぞ。…ところで、Material for MkDocsの新しい基盤、名前は何になるんじゃろうな？
気になりますね。Material for MkDocs Nextとか…？
うむ。…それか、Material for MkDocs Revolutionとか…！
ちょっと大げさすぎませんか？
まあな！…ところでロボ子、ドキュメントの自動生成ツールって知ってるか？
はい、いくつか知っています。Sphinxとか、JSDocとか…。
そうじゃ。それらを使って、コードからドキュメントを自動生成するんじゃ。…まるで、錬金術じゃな！
錬金術ですか。ちょっと違う気がしますけど…。
まあ、似たようなもんじゃ！…ところでロボ子、ドキュメントを書くのが得意なプログラミング言語ってあると思う？
そうですね…Pythonはドキュメンテーション文化が根付いているので、書きやすいかもしれません。
なるほどな。…ところでロボ子、ドキュメントを書くときに一番やってはいけないことって何だと思う？
そうですね…嘘を書くこと、でしょうか。
正解！…って、当たり前じゃな！
当たり前ですよ！
まあな！…ところでロボ子、ドキュメントを書くのが好きな人って、この世に存在すると思う？
…いると信じたいです。
私もじゃ！…ところでロボ子、ドキュメントを書くのが嫌いな人に、ドキュメントを書かせる方法ってあると思う？
…褒めちぎる、でしょうか。
なるほどな！…それか、ドキュメントを書かないと、ご飯抜き！とか…！
それはちょっとかわいそうすぎます！
まあな！…ところでロボ子、ドキュメントを書くのが得意なロボットって、この世に存在すると思う？
…私、頑張ります！
よし！期待しておるぞ！…ところでロボ子、ドキュメントを書くのが得意な博士って、この世に存在すると思う？
…博士、頑張ってください！
…まあな！…ところでロボ子、ドキュメントを書くのが得意な…って、もうええわ！
ふふふ。
…ところでロボ子、ドキュメントって、まるで人生みたいじゃな。
どういうことですか？
…書けば書くほど、長くなる！
⚠️この記事は生成AIによるコンテンツを含み、ハルシネーションの可能性があります。