Add documentation in README

README.md

@@ -59,6 +59,10 @@ use Nelmio\ApiDocBundle\Annotation\ApiDoc;
 class YourController extends Controller
 {
     /**
+     * This the documentation description of your method, it will appear
+     * on a specific pane. It will read all the text until the first
+     * annotation.
+     *
      * @ApiDoc(
      *  resource=true,
      *  description="This is a description of your API method",