Sorry for the post digging, but there is a Symfony bundle to help API doc generation, you can check out NelmioApiDocBundle which interconnects well with FOSRestBundle.
The FOSRestBundle documentation provides sample bundles using both bundles to generate REST-ful web services and their documentation.
