Documentation could be automatically created using Swagger. For example NelmioApiDocBundle can be used https://github.com/nelmio/NelmioApiDocBundle/blob/master/Resources/doc/index.md