Domande con tag 'javadocs'

Ci sono due tipi di documentazione. Un tipo, la Documentazione di implementazione , contiene informazioni sull'implementazione specifica di un costrutto (ad esempio Classe, Metodo, ecc.). È mirato al futuro me, manutentore, debugger e così v...

Ho iniziato a lavorare in una nuova azienda l'anno scorso. Sono abituato ad avere JavaDoc completi con annotazioni sugli edge case (come quello che succede quando null viene passato al metodo). Sto spingendo per apportare miglioramenti...

Ho letto il codice sorgente di alcune classi di librerie Java, in particolare CompletableFuture . Ho notato che gli autori fanno ampio uso di variabili criptiche (a singola lettera) nel codice, il che rende il codice probabilmente illeggibil...