Follow up to clean javadocs as per review comments - RESTWS-404