CLOUDIFY-1785 Added docletpath and changed the restful pom to use the new version of rest-doclet (0.5.0). Added request and response example generators and use them in the rest-doclet. Added some missing javadocs.