LPS-42068 Initial Javadoc edits

Please continue where I left of with re-adding Julio's Javadoc.

https://issues.liferay.com/browse/LRDOCS-841