Scaricare i siti web che utilizzano Javadoc

Informazioni su Javadoc

Uno sviluppatore Java scrive un blocco di commento sopra una classe e, anni dopo, quel commento è diventato una pagina web pubblica con un URL stabile. Javadoc è lo strumento che compie questa trasformazione, e le pagine che lascia dietro di sé sono l’unico motivo per cui un generatore di documentazione trova posto in un’indagine sulle tecnologie web.

Lo strumento Javadoc, distribuito con il Java Development Kit dal 1995 e mantenuto da Oracle con licenza GPL v2, legge i commenti contrassegnati in modo speciale nei file sorgente in Java e genera un insieme di pagine HTML collegate tra loro che descrivono ogni classe, metodo e campo. Le pagine prodotte hanno uno scheletro riconoscibile: un layout fisso a frame, una nota del generatore nell’intestazione della pagina e uno schema di denominazione dei file rimasto quasi invariato nei decenni successivi. Il rilevamento si basa su quello scheletro e non su qualcosa che il browser del visitatore esegue, il che lo rende affidabile quando trova una corrispondenza e cieco quando un progetto trasferisce la propria documentazione all’interno di un tema personalizzato.

A ottobre 2026 il conteggio si ferma a 2 siti nella categoria Documentation. Una cifra così ridotta non misura quanto Java si scriva nel mondo. Il dato conta invece gli host che pubblicano sul web aperto, a proprio nome, documentazione API generata, cioè una popolazione molto più ristretta e molto più interessante delle aziende che sviluppano in Java in generale.

Il pubblico di un elenco del genere è piuttosto preciso. Un’azienda che ospita in proprio le pagine generate da Javadoc è un’azienda che distribuisce una libreria, un SDK o un’API di piattaforma a sviluppatori esterni, e che ha deciso che la documentazione fa parte del prodotto e non è una pagina del wiki interno. I fornitori di strumenti per sviluppatori, i selezionatori di personale tecnico e chiunque mappi l’ecosistema Java per datore di lavoro anziché per repository si pongono tutti una domanda a cui una ricerca per singolo dominio non può rispondere, perché la domanda non è se un’azienda nota pubblichi documentazione, ma quali siano le aziende che lo fanno.

Vale la pena dichiarare i limiti con chiarezza. Gli aggregatori che ospitano documentazione generata per molti progetti non collegati tra loro risultano come un unico host, quindi la popolazione è sbilanciata verso le organizzazioni che pubblicano la documentazione sul proprio dominio. Inoltre la documentazione che risiede in un’intranet, cioè la maggior parte, non entra mai in una scansione pubblica. L’elenco scaricabile è quindi una stima per difetto e un punto di partenza, utile per gli host che nomina più che per il totale che riporta.