Полиглотные сайты документации: Дикий Запад технического письма
The Wild West of polyglot docs sites
Сайты документации для проектов с библиотеками на разных языках программирования вынуждены объединять выводы нескольких генераторов API-справки. Автор рассматривает две стратегии: трансформацию вывода (например, через Breathe) и публикацию как есть, как на pigweed.dev, где Doxygen, rustdoc и Sphinx сосуществуют. Проблемы: разный внешний вид, фрагментированный поиск, сложность навигации. Решение — универсальный заголовок и комплексный поиск на основе Pagefind.
Короче говоря, полиглотные сайты документации ощущаются как редко исследуемая граница технического письма, полная гремучих змей и перекати-поля. И, возможно, немного золота.