Updates the documentation for the 0.1.1-alpha release.

Fixes a couple of typos and justifications.

Removes reference to async handle function, it will remain synchronous, but may
invoke asynchronous processings during its execution.

Adds details about the next continuation in application.rst, route callback
takes three arguments now.

Author: arteymix

docs/application.rst

@@ -11,7 +11,7 @@ VSGI (Vala Server Gateway Interface) offers abstractions for different web
 server technologies. You can choose which implementation you want with
 a ``using`` statement, as they all respect a common interface.
 
-Two implementations exist at the moment and a few more are planned in the next
+Two implementations exist at the moment and a few more are planned in a future
 minor release.
 
 -  :doc:`server/soup`
@@ -26,11 +26,11 @@ Creating an application
 -----------------------
 
 An application is defined by a class that implements the ``VSGI.Application``
-interface. It declares a simple ``handle`` async function that takes
+interface. It declares a simple ``handle`` function that takes
 a :doc:`vsgi/request` and :doc:`vsgi/response` as input and process them.
 
-Valum provides a :doc:`router`, which provides powerful facilities for routing
-client requests. Your application is therefore an instance of that class.
+Valum provides a :doc:`router` with powerful facilities for routing client
+requests. Your application is an instance of that class.
 
 .. code:: vala
 
@@ -39,21 +39,22 @@ client requests. Your application is therefore an instance of that class.
 Binding a route
 ---------------
 
-An application constitute of a list of routes matching user requests. To
-declare a route, the ``Router`` class provides useful helpers and low-level
-utilities.
+An application constitute of a list of routes matching and handling user
+requests. The router provides helpers to declare routes which internally use
+a :doc:`route` instance.
 
 .. code:: vala
 
-    app.get ("", (req, res) => {
+    app.get ("", (req, res, next) => {
         res.write ("Hello world!".data);
     });
 
 Every route declaration has a callback associated that does the request
-processing. The callback receives two arguments:
+processing. The callback receives three arguments:
 
 -  a :doc:`vsgi/request` that describes a resource being requested
 -  a :doc:`vsgi/response` that correspond to that resource
+-  a ``next`` continuation to `keep routing`
 
 These two inherit respectively from ``InputStream`` and ``OutputStream``,
 allowing any synchronous and asynchronous stream operations. You can use

docs/ctpl.rst

@@ -10,13 +10,13 @@ Three primitive types and one composite type are supported:
 -  ``int``
 -  ``float``
 -  ``string``
--  ``array`` of preceeding types (but not of ``array``)
+-  ``array`` of preceding types (but not of ``array``)
 
 Creating views
 --------------
 
-The ``View`` class provides constructors to create views from
-``string``, file path and ``InputStream``.
+The ``View`` class provides constructors to create views from ``string``, file
+path and ``InputStream``.
 
 .. code:: vala
 
@@ -27,7 +27,8 @@ The ``View`` class provides constructors to create views from
     var template = new View.from_path ("path/to/your/template.tpl");
 
 It is a good practice to bundle static data in the executable using
-`GLib.Resource`_.
+`GLib.Resource`_. This practice is covered in the
+:doc:`recipes/static-resource` document.
 
 .. _GLib.Resource: http://valadoc.org/#!api=gio-2.0/GLib.Resource
 
@@ -62,8 +63,7 @@ Valum provides helpers for dumping `GLib.HashTable`_, `Gee.Collection`_,
 
 `GLib.HashTable`_, `Gee.Map`_ and `Gee.MultiMap`_ are pushed by pushing all
 their entries ony-by-one. Generated environment keys are the simple
-concatenation of the providen key, a underscore (``_``) and the entry
-key.
+concatenation of the provided key, a underscore (``_``) and the entry key.
 
 .. code:: vala
 

docs/getting-started.rst

@@ -4,7 +4,7 @@ Quickstart
 Assuming that Valum is built and installed correctly (view :doc:`installation`
 for more details), you are ready to create your first application!
 
-Unless you installed Valum with ``--prefix=/usr``, you have to export
+Unless you installed Valum with ``--prefix=/usr``, you might have to export
 ``PKG_CONFIG_PATH`` and ``LD_LIBRARY_PATH``.
 
 .. code-block:: bash

docs/index.rst

@@ -7,8 +7,8 @@ Valum web micro-framework
 .. image:: https://coveralls.io/repos/valum-framework/valum/badge.svg?branch=master
     :target: https://coveralls.io/r/valum-framework/valum?branch=master
 
-Valum is a web micro-framework written in Vala licensed under the LGPLv3. Its
-source code and releases are available on GitHub: `valum-framework/valum`_.
+Valum is a web micro-framework written in Vala and licensed under the LGPLv3.
+Its source code and releases are available on GitHub: `valum-framework/valum`_.
 
 This user documentation aims to be as complete as possible and covers topics
 that are not directly related to the framework, but essential for web

docs/persistency.rst

@@ -1,7 +1,7 @@
-Persistency
+Persistence
 ===========
 
-Multiple persistency solutions have bindings in Vala and can be used by Valum.
+Multiple persistence solutions have bindings in Vala and can be used by Valum.
 
 -  `libgda`_ for relational databases and more
 -  `memcached`_

docs/redirection-and-error.rst

@@ -16,8 +16,8 @@ the appropriate status code in the response for your convenience.
 Redirection (3xx)
 -----------------
 
-To perform a redirection, you have to throw a ``Redirection`` error and
-use the message as a redirect URL.
+To perform a redirection, you have to throw a ``Redirection`` error and use the
+message as a redirect URL.
 
 .. code:: vala
 
@@ -33,8 +33,7 @@ Client (4xx) and server (5xx) error
 
 Just like for redirection, client and server errors are thrown.
 
-Errors are predefined in ``ClientError`` and ``ServerError``
-enumerations.
+Errors are predefined in ``ClientError`` and ``ServerError`` enumerations.
 
 .. code:: vala