Re: API-s/Maven plugins for generation of REST API documentation

2014-11-19 Thread Mark Derricutt
On 19 Nov 2014, at 3:32, Jason van Zyl wrote: > The RAML tools look great and I have a lot of respect for the guys at > MuleSoft but just haven't had time to play with it. Online friend Jason Lee wrote a recent post on contract first with RAML: http://blogs.steeplesoft.com/posts/2014/10/15/co

Re: API-s/Maven plugins for generation of REST API documentation

2014-11-18 Thread Martin Todorov
Hi, Thanks for sharing your experiences! I will have a look at the links you guys sent me. After learning about Swagger, I have come across: https://github.com/kongchen/swagger-maven-plugin RAML looks promising, but I don't think there's a Maven plugin for that. Once again, thanks for your comme

Re: API-s/Maven plugins for generation of REST API documentation

2014-11-18 Thread Jason van Zyl
I am a long time user of Swagger and am fairly happy with it. I immediately ruled out API Blueprints because there's no Java implementation. I use Ruby everyday (almost) but I still find using Java and Ruby together sometimes difficult even with the presence of JRuby. RAML popped up a while ago

Re: API-s/Maven plugins for generation of REST API documentation

2014-11-17 Thread Jeff Jensen
Some additional ones to consider: Swagger [0] API BluePrint [1] RAML [2] I find the most ecosystem around Swagger; seems the most popular. Nice list of integrations (see the link to Maven plugin) [3] [0] http://swagger.io [1] http://apiblueprint.org [2] http://raml.org [3] https://github.com/swag

API-s/Maven plugins for generation of REST API documentation

2014-11-17 Thread Martin Todorov
Hi, Perhaps this isn't the right mailing list, but it's partially Maven-related... I've been wondering: are there some existing API-s and Maven plugins that can generate either of the following: a) Javadoc generators for REST API-s b) Markdown-styled documentation generators for REST API-s I'm a