Scaricare i siti web che utilizzano Haddock

Informazioni su Haddock

Chi scrive una libreria Haskell redige la documentazione sotto forma di annotazioni nei commenti del codice sorgente, avvia una build e carica tutto ciò che la build ha prodotto. Le pagine che finiscono poi sul server web sono normale HTML statico, ed è proprio questo a rendere possibile il riconoscimento dello strumento Haddock. La nostra impronta corrisponde alla struttura e alle convenzioni di markup dell’output generato, non a un servizio in esecuzione, quindi una corrispondenza descrive ciò che un dominio pubblica e non come quel dominio è ospitato.

La distinzione conta non appena si legge il conteggio. A ottobre 2026 il numero di domini su cui rileviamo Haddock è pari a 1, e il dato è una stima per difetto, non una misura di quanta documentazione Haskell esista sul web pubblico. La documentazione generata viene spesso servita da pochi hub centrali, integrata in un sito di documentazione più ampio con un tema personalizzato, oppure pubblicata su percorsi profondi che una scansione delle pagine d’ingresso di un dominio non raggiunge mai. Una personalizzazione del tema o un passaggio di post-elaborazione può cancellare i marcatori su cui ci basiamo, lasciando intatto lo strumento sottostante.

Tutto ciò che riguarda la struttura dello strumento rimanda a una toolchain più che a un prodotto. Il progetto è mantenuto sotto l’egida di Haskell.org, distribuito con licenza BSD e scritto proprio in Haskell, quindi il generatore di documentazione e il linguaggio che documenta seguono lo stesso ciclo di rilascio. Presente dal 2002, lo strumento è incluso in un’installazione standard di Haskell, il che rende il suo uso un’impostazione predefinita più che una decisione, e questa è una differenza reale rispetto a un componente che qualcuno ha valutato e scelto. La versione che abbiamo osservato è 2.14.3, e con una presenza di queste dimensioni un dato di versione descrive la build specifica che ha generato quelle particolari pagine, non una distribuzione su una base installata.

Per un ricercatore la domanda utile non è se un certo dominio usi Haddock, domanda a cui una singola ricerca risponde in un attimo. Scaricare l’elenco ha senso quando la domanda va nella direzione opposta: quali domini, in qualsiasi punto della scansione, pubblicano un qualsiasi output della toolchain Haskell. Rispondere partendo da ricerche per singolo dominio significa conoscere i domini in anticipo, e quelli interessanti sono di solito proprio quelli che nessuno ha pensato di controllare. Un’impronta della categoria Documentation come questa è un indicatore indiretto utilizzabile per individuare host di pacchetti, pagine di gruppi universitari e documentazione di librerie interne rimasta pubblica in sordina, e il dataset li restituisce tutti in un solo passaggio, ciascuno con il resto del suo stack rilevato nella stessa riga.