More links and details in the doc.

aiostream/stream/create.py

@@ -67,7 +67,7 @@ async def just(value):
 
 @operator
 async def call(func, *args, **kwargs):
-    """Call the given and generate a single value.
+    """Call the given function and generate a single value.
 
     Await if the provided function is asynchronous.
     """

docs/operators.rst

@@ -3,18 +3,24 @@ Stream operators
 
 .. module:: aiostream.stream
 
-The stream operators are separated in 7 categories:
+The stream operators produce objects of
+the `Stream <core.html#stream-base-class>`_ class.
+
+They are separated in 7 categories:
 
 .. include:: table.rst.inc
 
 They can be found in the :mod:`aiostream.stream` module.
 
+Custom stream operators can be created using the `@operator <core.html#operator-decorator>`_ decorator.
+
+
 Pipe-lining
 -----------
 
 Most of the operators have a :meth:`pipe` method corresponding to their equivalent pipe operator.
 They are also gathered and accessible through the :mod:`aiostream.pipe` module.
-The pipe operators allow a 2-step instanciation.
+The pipe operators allow a 2-step instantiation.
 
 For instance, the following stream::
 
@@ -28,7 +34,7 @@ and can be written as::
 
   ys = xs | pipe.map(lambda x: x**2)
 
-This synthax comes in handy when several operators are chained::
+This syntax comes in handy when several operators are chained::
 
   ys = (xs
       | pipe.operator1(*args1)

docs/presentation.rst

@@ -1,11 +1,11 @@
 Presentation
 ============
 
-aiostream_ provides a collection of stream operators that can be combined to create
+aiostream_ provides a collection of `stream operators <operators.html>`_ that can be combined to create
 asynchronous pipelines of operations.
 
 It can be seen as an asynchronous version of itertools_, although some aspects are slightly different.
-Essentially, all the provided operators return a unified interface called a stream.
+Essentially, all the provided operators return a unified interface called a `stream <core.html#stream-base-class>`_.
 A stream is an enhanced asynchronous iterable providing the following features:
 
   - **Operator pipe-lining** - using pipe symbol ``|``