REQS-537 PR comments - @deprecated to javadoc