Scaricare i siti web che utilizzano Doxygen

Informazioni su Doxygen

Quando rileviamo Doxygen non c’è nulla in esecuzione, e non c’è da parecchio tempo. L’impronta che riconosciamo è il residuo di un programma che ha finito il suo lavoro molto prima che la pagina venisse richiesta. La documentazione viene generata sulla macchina di uno sviluppatore o all’interno di una pipeline di build, e l’HTML che ne risulta viene copiato su un server web che non ha idea di che cosa l’abbia prodotto.

Lo strumento esiste dal 1997 ed è cresciuto insieme ai progetti in C++ che era nato per documentare. Riferimenti API generati, gerarchie di classi, grafi delle chiamate ed elenchi di file hanno tutti una struttura riconoscibile, ed è quella struttura, e non un qualche comportamento del server, che la nostra impronta riconosce. Un riscontro significa quindi una cosa precisa. Da qualche parte su questo dominio, un team di ingegneria ha pubblicato documentazione generata automaticamente per una codebase.

Registriamo 31 versioni distinte in circolazione, e la build riportata da una tipica pagina rilevata è la 1.9.8. La versione impressa nell’output generato è un fossile, non un rapporto sullo stato, perché registra la macchina che ha eseguito il generatore il giorno in cui la documentazione è stata creata e non dice nulla del sito di oggi. Una pagina che riporta una build vecchia è una pagina la cui documentazione non è più stata rigenerata da allora, il che rende la colonna delle versioni un indicatore approssimativo di quando un progetto ha pubblicato documentazione l’ultima volta, più che di ciò che il progetto usa oggi.

Lo strumento è pubblicato con licenza GPL v2 e i nostri dati non indicano alcun fornitore, il che corrisponde alla natura della cosa. Un software di questo genere si diffonde perché viene aggiunto a uno script di build, non perché viene venduto, e compare ovunque la cultura circostante preveda di scrivere commenti di documentazione nel codice sorgente. Siti di progetti open source, pagine di università e laboratori, fornitori di hardware che pubblicano materiale di riferimento per le proprie librerie e portali interni di ingegneria che risultano accessibili dall’esterno finiscono tutti nello stesso gruppo.

A ottobre 2026 l’impronta è visibile su 208 siti, e la popolazione che definisce è ristretta e utile. Un dominio presente nel file appartiene molto probabilmente a un’organizzazione che scrive codice, pubblica un’interfaccia o distribuisce una libreria, il che costituisce un filtro più preciso di quanto riesca di solito a fare una classificazione per settore. I fornitori di strumenti per sviluppatori in cerca di progetti con cui integrarsi, i recruiter che mappano le organizzazioni di ingegneria e i ricercatori che studiano le pratiche di documentazione nell’open source vogliono tutti esattamente quel filtro.

Valgono due limiti. La documentazione si trova spesso in una sottodirectory o in un sottodominio dedicato, quindi un conteggio per dominio sottostima quanti progetti distinti siano rappresentati e fa sì che più codebase non correlate condividano una sola riga. Le pagine generate, inoltre, sopravvivono ai progetti che le hanno prodotte, quindi un riscontro indica che la documentazione è stata pubblicata un tempo, non che qualcuno la mantenga ancora. I due limiti portano alla stessa conclusione. Il valore del file è la popolazione che isola, e interrogare un indirizzo alla volta non può mai ricostruire quella popolazione, perché bisognerebbe conoscere la risposta prima di poter fare la domanda.