Per quanto riguarda Java, credo sia proficuo seguire le indicazioni legate all'uso del tool Javadoc descritte in questo articolo.