Update docs

demos/polls/aiohttpdemo_polls/routes.py

@@ -2,12 +2,11 @@
 
 
 def setup_routes(app, project_root):
-    add_route = app.router.add_route
-    add_route('GET', '/', index)
-    add_route('GET', '/poll/{question_id}', poll, name='poll')
-    add_route('GET', '/poll/{question_id}/results',
-              results, name='results')
-    add_route('POST', '/poll/{question_id}/vote', vote, name='vote')
+    app.router.add_route('GET', '/', index)
+    app.router.add_route('GET', '/poll/{question_id}', poll, name='poll')
+    app.router.add_route('GET', '/poll/{question_id}/results',
+                         results, name='results')
+    app.router.add_route('POST', '/poll/{question_id}/vote', vote, name='vote')
     app.router.add_static('/static/',
                           path=str(project_root / 'static'),
                           name='static')

docs/tutorial.rst

@@ -144,6 +144,10 @@ and second table is choice table:
 | question_id   |
 +---------------+
 
+TBD: aiopg.sa.create_engine and pushing it into app's storage
+
+TBD: graceful cleanup
+
 
 .. _aiohttp-tutorial-views:
 
@@ -156,16 +160,17 @@ next Python code inside file (``polls/aiohttpdemo_polls/views.py``)::
     from aiohttp import web
 
 
-    class SiteHandler:
-        async def index(self, request):
-            return web.Response(text='Hello Aiohttp!')
+    async def index(self, request):
+        return web.Response(text='Hello Aiohttp!')
 
 This is the simplest view possible in Aiohttp. Now we should add ``index`` view
 to ``polls/aiohttpdemo_polls/routes.py``::
 
-    def setup_routes(app, handler, project_root):
-        add_route = app.router.add_route
-        add_route('GET', '/', handler.index)
+    from .views import index
+
+
+    def setup_routes(app, project_root):
+        app.router.add_route('GET', '/', index)
 
 Now if we open browser we can see::
 
@@ -181,17 +186,18 @@ Templates
 Let's add more useful views::
 
    @aiohttp_jinja2.template('detail.html')
-   async def poll(self, request):
-       question_id = request.match_info['question_id']
-       try:
-           question, choices = await db.get_question(self.postgres,
-                                                     question_id)
-       except db.RecordNotFound as e:
-           raise web.HTTPNotFound(text=str(e))
-       return {
-           'question': question,
-           'choices': choices
-       }
+   async def poll(request):
+       async with request['db'].acquire() as conn:
+           question_id = request.match_info['question_id']
+           try:
+               question, choices = await db.get_question(conn,
+                                                         question_id)
+           except db.RecordNotFound as e:
+               raise web.HTTPNotFound(text=str(e))
+           return {
+               'question': question,
+               'choices': choices
+           }
 
 Templates are very convinient way forweb page writing. We return a
 dict with page content, ``aiohttp_jinja2.template`` decorator
@@ -235,3 +241,9 @@ Fortunatelly it can be done easy by single call::
 
 
 where ``project_root`` is the path to root folder.
+
+
+Middlewares
+-----------
+
+TBD