LPS-29422 review javadoc

@juliocamarero @KocsisDaniel - Here is edited Javadoc. Thanks.