Only API classes and SPI classes should be included Classes in .impl packages (and nested packages) should not appear in the javadoc so as to discourage using those, and to make the javadoc lighter.