#395 Improve javadocs