[doc] Documentation, my dear. Half of the work, looks you are a little behind on quotas ...

docs/tutorial/index.rst

@@ -9,17 +9,26 @@ python code in charge of handling similar shaped independant lines of data.
 
 Bonobo *is not* a statistical or data-science tool. If you're looking for a data-analysis tool in python, use Pandas.
 
-Bonobo is a lean manufacturing assembly line for data that let you focus on the actual work instead of the plumbery.
+Bonobo is a lean manufacturing assembly line for data that let you focus on the actual work instead of the plumbery
+(execution contexts, parallelism, error handling, console output, logging, ...).
 
 Bonobo uses simple python and should be quick and easy to learn.
 
 Tutorial
 ::::::::
 
-Warning: the documentation is still in progress. Although all content here should be accurate, you may feel a lack of
-completeness, for which we plaid guilty and apologize. If there is something blocking, please come on our
-`slack channel <https://bonobo-slack.herokuapp.com/>`_ and complain, we'll figure something out. If there is something
-that did not block you but can be a no-go for others, please consider contributing to the docs.
+.. note::
+
+    Good documentation is not easy to write. We do our best to make it better and better.
+
+    Although all content here should be accurate, you may feel a lack of completeness, for which we plaid guilty and
+    apologize.
+
+    If you're stuck, please come and ask on our `slack channel <https://bonobo-slack.herokuapp.com/>`_, we'll figure
+    something out.
+
+    If you're not stuck but had trouble understanding something, please consider contributing to the docs (via github
+    pull requests).
 
 .. toctree::
     :maxdepth: 2