LPS-31056 portal safe javadoc

Hi Tom, Here are the edits to your Javadoc from @codyhoag and me. Thanks.