Scaricare i siti web che utilizzano DocFX

Informazioni su DocFX

La versione impressa su una pagina costruita da un generatore statico è un fossile, non un servizio in esecuzione. Quando un visitatore apre la documentazione, DocFX non viene eseguito. Lo strumento ha girato una sola volta, su una macchina di build, ha trasformato i commenti nel codice sorgente e il Markdown in HTML e ha lasciato il proprio nome e la propria versione nel markup, dove il nostro crawler li trova anni dopo. Ogni conclusione tratta da questa impronta discende da questo unico fatto.

I dati di versione lo mostrano con la massima chiarezza. Registriamo 26 versioni distinte nelle pagine che abbiamo visto, con 2.59.4.0 come la più frequente nel nostro campione, e la dispersione è molto più ampia di quanto sarebbe per un software che si aggiorna da solo. Un sito di documentazione viene generato al momento del rilascio e poi lasciato com’è, quindi la versione registrata è quella della toolchain nel giorno in cui la documentazione è stata pubblicata l’ultima volta. Lo strumento è pubblico dal 2016, abbastanza a lungo perché alcune pagine che troviamo siano state generate da release che nessuno supporta più. Qui la frammentazione misura quanto tempo è passato dall’ultima pubblicazione della documentazione di ciascun progetto, il che è un segnale davvero utile e non il problema di manutenzione che un’ampia dispersione di versioni indica altrove.

Il pubblico deriva dalla toolchain. Microsoft pubblica il generatore, scritto in C#, con licenza MIT, e il suo input nativo sono i commenti di documentazione che quello stesso linguaggio incorpora nei file sorgente, quindi un sito che porta il marcatore appartiene quasi sempre a un progetto o a un’azienda che lavora all’interno di quell’ecosistema. Compaiono librerie open source, team di piattaforma interni che pubblicano la documentazione di riferimento delle proprie API e fornitori che documentano una libreria client. I siti di marketing invece non compaiono, perché nessuno ricorre a un generatore di documentazione API per costruirne uno.

Il risultato è un elenco con una caratteristica che le impronte web generiche hanno di rado. Identificare un generatore di documentazione significa identificare lo stack tecnologico dei team di sviluppo dell’organizzazione che sta dietro il sito, non solo la tecnologia del sito stesso. Un’azienda la cui documentazione pubblica è generata dal proprio codice sorgente sta dicendo in quale linguaggio scrivono i suoi ingegneri, che distribuisce una libreria o un’API a sviluppatori esterni e che qualcuno è responsabile di un processo di rilascio abbastanza disciplinato da arrivare a pubblicare materiale di riferimento.

I limiti meritano di essere detti chiaramente. La documentazione si trova spesso su piattaforme di hosting dei progetti o in un percorso all’interno di un dominio aziendale più grande, quindi un’impronta contata per dominio perderà alcune installazioni e ne fonderà insieme altre. I siti che rimuovono il marcatore del generatore durante la build spariscono del tutto dal conteggio. A ottobre 2026 rileviamo lo strumento su 148 siti, e il numero di progetti che lo usano davvero è più alto, perché usare un generatore e lasciarne la firma nell’output pubblicato sono due cose diverse.

Il file risponde a una domanda che una singola verifica su un dominio non può affrontare: la forma di quella popolazione, cioè quali settori documentano il proprio codice apertamente, come la dispersione delle versioni corrisponde a quanto di recente ciascun progetto ha pubblicato e quali domini ospitano materiale di riferimento che non viene rigenerato da moltissimo tempo. Per rispondere a una qualsiasi di queste domande serve l’intero elenco in una volta.