direi di partire dal javadoc, generi la classica documentazione con lui, e quindi ci sarà una pagina per ogni classe e tutto strutturato come è la convenzione Java (con lo stesso stile della documentazione ufficiale di Sun per intenderci), e dopo vicino ogni classe metti anche il suo sorgente, magari colorato in html esportandolo con qualche IDE (qualsiasi IDE che si rispetti ti permette di esportare il sorgente colorato in html) e nel sorgente nel commento documentativo della classe
/**
*/
metti il tag @see che punta alla pagina contenente il sorgente completo di quella classe.
Ad ogni modo escludo categoricamente il fornire tutti i sorgenti delle classi in blocco in un file solo, senza un ottimo IDE che permette la navigazione veloce fra metodi e altre classi sarebbe un incubo guardare il sorgente.
se non è chiara la mia idea provo a fare qualche esempio magari più pratico
Ultima modifica effettuata da netarrow il 12/09/2007 alle 18:51 |