#POULPE-484 Source improvements (JavaDocs in the main)