RetailCRM-Mirror/NelmioApiDocBundle
1
0
Fork 0
mirror of https://github.com/retailcrm/NelmioApiDocBundle.git synced 2025-02-09 11:09:26 +03:00
Code Issues Projects Releases Wiki Activity

Merge pull request #1177 from nelmio/method-annotation-doc-improve

Browse Source 
Provide example for action summary and description
This commit is contained in:
Guilhem N 2018-01-09 12:51:51 +01:00 committed by GitHub
commit 4bd1b3ebe6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Resources/doc/index.rst
View File

@ -123,6 +123,10 @@ To document your routes, you can use the SwaggerPHP annotations and the
class UserController
{
/*
* List the rewards of the specified user.
*
* This call takes into account all confirmed awards, but not pending or refused awards.
*
* @Route("/api/{user}/rewards", methods={"GET"})
* @SWG\Response(
* response=200,
@ -146,6 +150,8 @@ To document your routes, you can use the SwaggerPHP annotations and the
}
}
The normal PHP docblock for the controller method is used for the summary and description.
Use models
----------