Esiste una procedura di controllo delle versioni per l'introduzione di nuove funzionalità nella specifica Javadoc? La mia domanda è ispirata ai tag apparentemente nuovi: @apiNote, @implSpec e @implNote visualizzati nei documenti di origine di Java 8. I'm aware that these tags are not standard and subject to change - se è stato deciso dagli Java Gods che questi tag siano standard in una nuova versione di Javadoc, dove uno sviluppatore potrebbe trovare queste informazioni?Esiste un processo di controllo delle versioni per lo strumento Javadoc?
Ho letto i documenti che fanno riferimento a Oracle versioni Javadoc a partire da 1.1 e termina a 1.4, che potrebbe indurre a credere che con ogni versione di Java c'è una nuova versione Javadoc, ma non riesco a trovare alcuna prova a supporta questa ipotesi.
L'unico riferimento legittimo che abbia mai trovato relativo alle specifiche Javadoc/best practice/tag accettati è: How to Write Doc Comments for the Javadoc Tool.
Non so perché il thread di posta elettronica non sia una fonte affidabile di informazioni; in esso menziona che quei tag non sono standard e che sono soggetti a modifiche. – Makoto
@Makoto Il punto di questa domanda non sono quei tag in particolare, sto cercando di capire come funziona il versioning di Javadoc e dove vivono le informazioni sulle nuove funzionalità. Ho aggiornato la domanda per eventualmente affrontare la confusione che hai riscontrato. –