py3.5+: use await/async in docs and examples

[oberstet]

Now that we have deprecate support for python < 3.5, we should use & promote the async/await syntax in:

• documentation
• examples

Docs are living here, are writeen in ReST, can be build manually (using make docs) and are published automatically (from Travis) to RTD (here)