Javadoc: come lo miglioriamo?
February 7th, 2006
Sun sta facendo un sondaggio sul tool javadoc per capire come migliorarlo. Le domande sono poche e in due minuti hai la possibilità di dire la tua su come ti piacerebbe che fosse la documentazione di nuova generazione.
Ma….. io sostengo che il codice scritto bene si autocommenta e quindi male non sarebbe che anche si auto-javadoccasse.
Cioè se ho scritto un bellissimo metodo che si chiama
getAllObjectsByDate è piuttosto lapalissiano che dentro al Javadoc ci possa automaticamente essere scritto “gets all objects given a date”.