Contexte et migration vers la Linux Foundation
Docsy, le thème open‑source développé à l'origine par les rédacteurs techniques de Google, a été transféré à la Linux Foundation lors du Open Source Summit Europe 2026. Ce déplacement vise à placer le projet au cœur d’un écosystème où de nombreux projets, dont Kubernetes et plusieurs initiatives sandbox, utilisent déjà le thème pour leurs sites de documentation. Le code de Docsy reste sous licence Apache 2.0, ce qui garantit une réutilisation libre dans les environnements cloud et DevOps.
Mécanisme de prise en charge des agents IA
La première phase de support IA a été introduite dans la version 0.15.0. Cette version active, de façon expérimentale et opt‑in, la génération d’un fichier llms.txt qui indexe l’ensemble du site, ainsi que des versions Markdown parallèles pour chaque page, la page d’accueil et les sections. Un lien « View Markdown » permet aux outils automatisés d’accéder directement à la source texte, évitant ainsi le parsing du HTML. Le format Markdown expose les titres, les liens et les extraits de code dans une structure linéaire, plus adaptée aux modèles de langage qui consomment des séquences de tokens.
Implications pour la documentation technique
En fournissant un index dédié et des alternatives Markdown, Docsy facilite le processus de récupération « just‑in‑time » décrit par Anthropic : un agent peut interroger l’index, sélectionner les pages pertinentes, charger leur version Markdown et les injecter dans le contexte d’inférence. Cette approche réduit le besoin d’inclure l’intégralité du site dans le prompt, limitant la consommation de tokens et améliorant la pertinence des réponses. Pour un assistant de codage, cela signifie pouvoir extraire, par exemple, les instructions d’authentification d’une API avant de générer une requête.
Limites et perspectives
Le support IA reste expérimental. La génération du fichier llms.txt nécessite d’activer explicitement la fonctionnalité, et aucune garantie n’est fournie quant à la qualité des réponses des modèles qui consomment ces données. De plus, le processus ne modifie pas les modèles eux‑mêmes ; il ne s’agit que d’une couche d’accès aux documents existants. La communauté devra surveiller l’impact sur les performances de génération de site Hugo, notamment la charge supplémentaire liée à la création des fichiers Markdown parallèles. À moyen terme, l’intégration pourrait s’étendre à d’autres formats ou à des pipelines CI/CD afin d’automatiser la mise à jour de l’index lors de chaque déploiement.
