Minor fixes from testing with real APIs.  In particular, RAML wants legal URIs for paths and a limited set of URL param types.  Also added support for extracting URL parameter descriptions from resource javadoc headers.