Any API made with "Swagger" - http://petstore.swagger.io
Made w/ http://swagger.io
But none of these are actually able to be generated from within our CakePHP src in a nice way - the closest we got was with the package swagger-php - but still it's not really "DRY"...
So all of this (and my laziness) got me thinking - is there a smarter way than just starting to annotate like a crazy - to start extrating this kind of code from our src, and it indeed seems reasonable to do it.
So first of all - does anyone have any super-awesome toolset, that we just totally missed - and second, what would be the most awesome docs tool you could imagine?
I'm wrapping my head around something that would pair up nicely with the idea behind Crud - it might not get you all the way by doing nothing, but it's damn close.
Also, if one were to start up a plugin for generating docs for CakePHP projects - should it be independent of other projects like Swagger, IODocs and Slate? I guess we have 3 options:
A) Our own
B) Using one specific provider (eg. Swagger)
C) Using adapters for 3rd party providers - it's more or less the same kind of info we all want as output, it's just a matter of syntax and formalities in regard to generate those docs, so it's definitely possible to add a layer of abstraction with adapters to the providers people want to use.
Last thing - does this have any interest at all - or are we the single company that has this "issue"? :-)