@yole I use asciidoc to write reference documentation for my projects and for java there is asciidoc doclet so I can use asciidoc instead of javadoc, that way it is much easier to import java api docs into reference documentation to avoid duplication.