Javadoc cleanup for the new public clustering API

Javadoc cleanup for follow Javadoc rules and recommendations for the new public clustering API.