LRDOCS-1470 Edit Javadoc based on Manuel's feedback