#POULPE-483 Javadocs improved