Document endpoint tags (#58)

Author: diasdm

docs/api.rst

@@ -31,7 +31,7 @@ SchemaGenerator
                 By default the value is ``{"title": "API", "version": "1.0"}``
 
 
-   .. method:: api()
+   .. method:: api(tags=())
 
       Use as a decorator to register a handler function to be part of the API schema.
 
@@ -43,7 +43,9 @@ SchemaGenerator
       in the schema. When the handler is executed, the request body will be read and
       validated against that type.
 
-   .. method:: api_view()
+      :param tags: Sequence of strings used to specify tags to group endpoints.
+
+   .. method:: api_view(tags=())
 
       Use as a decorator to register a :class:`aiohttp.web.View` class to be part of
       the API schema. This will register each endpoint method defined in the class.

docs/index.rst

@@ -88,6 +88,12 @@ You can use docstrings to customise the summary and description shown in the sch
         description.
         """
 
+Tags
+++++
+
+Tags can be added to group endpoints using the ``tags`` parameter in the decorators
+(see :meth:`aiohttp_schema.SchemaGenerator.api`).
+
 Library Installation
 --------------------