some grammatical and typo fixes (#3)

* small tweaks to documentation, typos, grammar etc

* fixed semantic error in hello_word.rst docs

Author: mentaal

getting_started.rst

@@ -5,9 +5,12 @@ Getting Started
 Get Python 3.5
 ==============
 
-Sorry but this documentation is written for Python 3.5 to get the new ``async``
+Sorry but this documentation is written for Python 3.5 to avail of the new ``async``
 and ``await`` keywords.
 
+.. would be good to have some word about installing on Windows
+* Windows: the easiest way to use Python 3.5 would be to use a package manager like Conda
+  There are instructions for using a python 3.5 environment in `Conda here <http://conda.pydata.org/docs/py2or3.html#create-a-python-3-5-environment>`_.
 * Mac OS X: install `Homebrew </usr/bin/ruby -e "$(curl -fsSL
   https://raw.githubusercontent.com/Homebrew/install/master/install)">`_ and
   then type ``brew install python3``
@@ -22,6 +25,9 @@ Create a virtual environment::
 
     python3 -m venv venv
 
+.. note::
+    Depending on your platform, the python 3 interpreter could be invoked by ``python`` instead. This is the case for Conda on Windows for example.
+
 Install aiohttp in the virtual environment::
 
     venv/bin/python -m pip install -U aiohttp

glossary.rst

@@ -9,7 +9,7 @@ Glossary
 .. glossary::
 
     coroutine
-        It's a piece of code that can be paused and resumed. Whereas threads are preemptively multitasked by the operating system, coroutines multitask cooperatively: they choose when to pause, and which coroutine to run next.
+        A coroutine is a piece of code that can be paused and resumed. In contrast to threads which are preemptively multitasked by the operating system, coroutines multitask cooperatively. I.e. they choose when to pause (or to use terminology for coroutines before 3.4 - ``yield``) execution. They can also execute other coroutines.
 
     event loop
         The event loop is the central execution device to launch execution of coroutines and handle I/O (Network, sub-processes...)
@@ -18,4 +18,4 @@ Glossary
         It's like a mailbox where you can subscribe to receive a result when it will be done. More details in `official documentation <https://docs.python.org/3/library/asyncio-task.html#future>`_
 
     task
-        It represents the execution of a coroutine and take care the result in a future. More details in `official documentation <https://docs.python.org/3/library/asyncio-task.html#task>`_
+        It represents the execution of a coroutine and take care the result in a future. More details in `official documentation <https://docs.python.org/3/library/asyncio-task.html#task>`_

hello_world.rst

@@ -8,11 +8,11 @@ schedule them in the asyncio :term:`event loop <event loop>`.
 Simple coroutine
 ----------------
 
-Example using the :meth:`BaseEventLoop.run_until_complete` method to schedule
+Example using the :meth:`BaseEventLoop.run_until_complete` method to schedule a
 simple function that will wait one second, print 'hello' and then finish.
 
 Because it is launched with `run_until_complete`, the :term:`event loop <event loop>` itself
-with terminate once the :term:`coroutine <coroutine>` is completed.
+will terminate once the :term:`coroutine <coroutine>` is completed.
 
 .. literalinclude:: examples/hello_world.py
 
@@ -24,7 +24,7 @@ This second example show how you can schedule multiple :term:`coroutines <corout
 event loop, and then run the :term:`event loop <event loop>`.
 
 Notice that this example will print 'second_hello' before 'first_hello',
-as the second :term:`task <task>` scheduled waits longer that the first one before printing.
+as the first :term:`task <task>` scheduled waits longer that the second one before printing.
 
 Also note that this example will never terminate, as the  :term:`loop <event loop>` is asked to
 `run_forever`.

index.rst

@@ -2,7 +2,7 @@
 Asyncio Documentation
 +++++++++++++++++++++
 
-Chapiter 1: First steps with asyncio
+Chapter 1: First steps with asyncio
 ====================================
 
 .. toctree::
@@ -16,7 +16,7 @@ Chapiter 1: First steps with asyncio
    getting_help.rst
 
 
-Chapiter 2: Advanced topics
+Chapter 2: Advanced topics
 ===========================
 
 .. toctree::