... e non a caso, per certe "cose" esistono gli standards ... l'approccio javadoc è uno standard de facto.

Lo sai perchè ?

Perchè hai i commenti sul metodo e se cambi qualcosa non devi fare alcun giro astruso, banalmente scorrere più su ed aggiungere note sulla modifica di quella versione, cambiamenti e quant'altro ...questa si chiama manutenzione, tu non ne hai bisogno ? tu preferisci leggere lo storico del metodo da un'altra parte, lavorare sul metodo, aggiornare dall'altra parte la documentazione per non permettere a nessuno, una volta scaricata la sola classe dell'applicativo di avere a portata di mano i commenti senza doverli cercare ?


Liberissimo di procedere col tuo applicativo personale che, secondo il mio umile punto di vista, solo tu utilizzerai.

E' vero che il mondo è bello perchè è vario, ma è anche vero che la gente per bere porta il bicchiere alla bocca, non lo morde in verticale per fare una capriola veloce ... poi se hai validi motivi per ritenere un sistema comodo a tutto il mondo "scomodo" o altro ancora, siamo tutti qui pronti ad ascoltare quali migliorie introdurrebbe la tua proposta.