[#61] Update javadoc with more details