Télécharger les sites web qui utilisent DocFX

À propos de DocFX

La version inscrite sur une page fabriquée par un générateur statique est un fossile, pas un service en marche. Rien n’exécute DocFX quand un visiteur ouvre la documentation. L’outil a tourné une fois, sur une machine de compilation, a transformé des commentaires de code et du Markdown en HTML, et a laissé son nom et sa version dans le balisage, là où notre robot les retrouve des années plus tard. Toute conclusion tirée de cette empreinte découle de ce seul fait.

C’est dans les données de version que cela se voit le mieux. Nous détenons 12 versions distinctes sur l’ensemble des pages que nous avons vues, 2.59.4.0 revenant le plus souvent dans notre échantillon, et la dispersion est bien plus large qu’elle ne le serait pour un logiciel qui se met à jour tout seul. Un site de documentation est généré au moment d’une publication puis laissé tranquille, de sorte que la version enregistrée est celle de la chaîne d’outils au jour où la documentation a été publiée pour la dernière fois. L’outil est public depuis 2016, assez longtemps pour que certaines pages que nous trouvons aient été fabriquées par des versions que plus personne ne prend en charge. La fragmentation mesure ici depuis combien de temps chaque projet n’a plus publié de documentation, ce qui est un signal réellement utile plutôt que le problème de maintenance qu’une large dispersion de versions laisse supposer ailleurs.

Le public découle de la chaîne d’outils. Microsoft publie le générateur sous licence MIT, écrit en C#, et son entrée native est constituée des commentaires de documentation que ce même langage intègre dans les fichiers source, si bien qu’un site qui porte le marqueur appartient presque toujours à un projet ou à une entreprise qui travaille dans cet écosystème. Les bibliothèques open source, les équipes plateforme internes qui publient une référence d’API et les fournisseurs qui documentent une bibliothèque cliente apparaissent tous. Les sites de communication, non, parce que personne ne va chercher un générateur de documentation d’API pour en construire un.

Le résultat est une liste dotée d’une propriété que les empreintes web générales ont rarement. Identifier un générateur de documentation, c’est identifier la stack d’ingénierie de l’organisation derrière le site, et pas seulement la technologie du site lui-même. Une entreprise dont la documentation publique est générée depuis son propre code vous dit dans quoi ses ingénieurs écrivent, qu’elle livre une bibliothèque ou une API à des développeurs extérieurs, et que quelqu’un porte un processus de publication assez discipliné pour diffuser une documentation de référence tout court.

Les limites méritent d’être dites franchement. La documentation se trouve souvent sur un hébergement de projet ou sous un chemin à l’intérieur d’un domaine d’entreprise plus vaste, si bien qu’une empreinte comptée par domaine manque certains déploiements et en fusionne d’autres. Les sites qui retirent le marqueur du générateur pendant leur compilation disparaissent purement et simplement du décompte. En octobre 2026 nous le détectons sur 39 sites, et le nombre de projets qui utilisent réellement l’outil est plus élevé, parce qu’utiliser un générateur et laisser sa signature dans la sortie publiée sont deux choses différentes.

Ce à quoi le fichier répond, et qu’une vérification sur un seul domaine ne peut pas donner, c’est la forme de cette population, quels secteurs documentent leur code au grand jour, comment la dispersion des versions recoupe la date de la dernière publication de chaque projet, et quels domaines portent une documentation de référence qui n’a pas été reconstruite depuis très longtemps. Répondre à l’une quelconque de ces questions demande la liste entière d’un seul tenant.