The Wild West of polyglot docs sites
Summary
This article discusses the challenge of building polyglot docs sites when a project ships libraries in multiple languages, each with its own API reference generator. It outlines two high-level strategies: Transformation, which adapts outputs from tools like Doxygen or rustdoc into the main docs system, and Turducken, which combines Doxygen, rustdoc, and Sphinx outputs into a single site. It also describes practical UX improvements such as a universal header and a comprehensive search powered by Pagefind to unify navigation, search, and breadcrumbs across subsites, using pigweed.dev as a practical example.