Now using Swagger Jack for nice YAML resource descriptions and validation.  There's currently a bug with swagger-jack 1.6.1 which means the discovery endpoint doesn't work with  Swagger UI