The NelmioApiDocBundle bundle allows you to generate a decent documentation for your APIs.
Swagger is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web service
https://github.com/wordnik/swagger-core/wiki