異なる言語のドキュメントを1つに束ねる「polyglot docs site」の荒野
The Wild West of polyglot docs sites
複数言語のライブラリを提供するプロジェクトでは、Doxygen、rustdoc、Sphinxなど異なるAPIリファレンス生成ツールの出力を1つのドキュメントサイトに統合する必要がある。pigweed.devでは各ツールの出力をそのまま活かす「turducken」戦略を採用。Pagefindによる横断検索と共通ヘッダーで、別々のサブサイトを繋ぐ試みが進んでいる。
polyglot docs siteは、技術文書の世界でもほとんど開拓されていない辺境のように感じられる。ガラガラヘビやタンブルウィードだらけで、おまけに少しばかり金鉱もあるのかもしれない。