JCLOUDS-458: Addressing suggestions in PR-31

minor changes


Move the comment to the `@return` bit?