SSP-2461 Refactor javadoc