Tou dokumentaci mas na mysli asi JavaDoc - urcitou syntaxi psane komentare, z kterych se automaticky vygeneruje html help.

Lehky uvod pro zacatek viz napr.
http://www.builder.cz/art/java/javadoc.html