outeredge/SwaggerModule — pull request #2 by bakura10 (2013-01-20 16:22:39+00:00)
Title: Rewrite of SwaggerModule

Hi,

This is mostly a rewrite of SwaggerModule. It updates the module to latest Swagger-PHP and latest ZF 2 changes.

It furthermore allow to display the API from annotated classes by going to the www.mywebsite.com/api/documentation route.

It's not terminated yet, as I have to finish the views, as well as tweak the swagger-ui CSS to adapt us to our needs (I'll try to prefix all the classes and identifiers in order to avoid name clashes).

I've thought first about going to the console way (generate json or html swagger doc), but there are a few limitations because the Console request miss some important things (basePath, Request....).

Furthermore, I'm not sure if we should have all the features from Swagger UI. It uses plenty of javascript libraries to simulate the REST endpoint, I'm not sure if we should go this far.

What do you think ?