Update FAQ

docs/faq.rst

@@ -1,18 +1,33 @@
-Frequently Asked Questions
-==========================
+FAQ
+===
+
 .. contents::
    :local:
 
 Are there any plans for @app.route decorator like in Flask?
 -----------------------------------------------------------
-There are couple issues here:
 
-* This adds huge problem name "configuration as side effect of importing".
-* Route matching is order specific, it is very hard to maintain import order.
-* In semi large application better to have routes table defined in one place.
+We have it already (*aiohttp>=2.3* required):
+:ref:`aiohttp-web-alternative-routes-definition`.
+
+The difference is: ``@app.route`` should have an ``app`` in module
+global namespace, which makes *circular import hell* easy.
+
+*aiohttp* provides a :class:`~aiohttp.web.RouteTableDef` decoupled
+ from an application instance::
+
+   routes = web.RouteTableDef()
+
+   @routes.get('/get')
+   async def handle_get(request):
+       ...
+
+
+   @routes.post('/post')
+   async def handle_post(request):
+       ...
 
-For this reason feature will not be implemented. But if you really want to
-use decorators just derive from web.Application and add desired method.
+   app.router.add_routes(routes)
 
 
 Has aiohttp the Flask Blueprint or Django App concept?

docs/web.rst

@@ -320,6 +320,9 @@ viewed using the :meth:`UrlDispatcher.named_resources` method::
    :meth:`UrlDispatcher.resources` instead of
    :meth:`UrlDispatcher.named_routes` / :meth:`UrlDispatcher.routes`.
 
+
+.. _aiohttp-web-alternative-routes-definition:
+
 Alternative ways for registering routes
 ---------------------------------------