Polyglotte Doku-Seiten: Wilder Westen der Technischen Redaktion
The Wild West of polyglot docs sites
Polyglotte Doku-Seiten vereinen API-Referenzen aus mehreren Sprachen, die von verschiedenen Generatoren wie Doxygen, rustdoc und Sphinx erzeugt werden. Der Artikel beschreibt zwei Strategien: Transformation der Ausgaben in ein einheitliches Format oder Veröffentlichung als separate Unterseiten (Turducken). Letzteres führt zu inkonsistentem Aussehen, fragmentierter Suche und schwieriger Navigation. Am Beispiel von pigweed.dev zeigt der Autor, wie ein universeller Header und die Suchbibliothek Pagefind diese Probleme mildern.
Kurz gesagt, polyglotte Doku-Seiten fühlen sich wie eine kaum erkundete Grenzregion des technischen Schreibens an, voller Klapperschlangen und Steppenläufer. Und vielleicht auch ein wenig Gold.