Merge remote-tracking branch 'upstream/master' into develop

docs/extension/jupyter.rst

@@ -16,7 +16,7 @@ Install `bonobo` with the **jupyter** extra::
 Install the jupyter extension::
 
     jupyter nbextension enable --py --sys-prefix widgetsnbextension
-    jupyter nbextension enable --py --sys-prefix bonobo.ext.jupyter
+    jupyter nbextension enable --py --sys-prefix bonobo.contrib.jupyter
 
 Development
 :::::::::::
@@ -25,8 +25,8 @@ You should favor yarn over npm to install node packages. If you prefer to use np
 
 To install the widget for development, make sure you're using an editable install of bonobo (see install document)::
 
-    jupyter nbextension install --py --symlink --sys-prefix bonobo.ext.jupyter
-    jupyter nbextension enable --py --sys-prefix bonobo.ext.jupyter
+    jupyter nbextension install --py --symlink --sys-prefix bonobo.contrib.jupyter
+    jupyter nbextension enable --py --sys-prefix bonobo.contrib.jupyter
 
 If you want to change the javascript, you should run webpack in watch mode in some terminal::
 

docs/guide/purity.rst

@@ -135,7 +135,6 @@ Now let's see how to do it correctly:
         }
 
     def new_dict_and_yield():
-        d = {}
         for i in range(100):
             # Different dict each time.
             yield {

docs/tutorial/1-init.rst

@@ -59,6 +59,8 @@ To inspect the graph of your first transformation:
 
     You must `install the graphviz software first <https://www.graphviz.org/download/>`_. It is _not_ the python's graphviz
     package, you must install it using your system's package manager (apt, brew, ...).
+    
+    For Windows users: you might need to add an entry to the Path environment variable for the `dot` command to be             recognized
 
 .. code-block:: shell-session
 
@@ -203,12 +205,17 @@ Main Block
                 get_graph(**options),
                 services=get_services(**options)
             )
-
+            
 Here, the real thing happens.
 
 Without diving into too much details for now, using the :func:`bonobo.parse_args` context manager will allow our job to
 be configurable, later, and although we don't really need it right now, it does not harm neither.
 
+.. note::
+
+    This is intended to run in a console terminal. If you're working in a jupyter notebook, you need to adapt the thing to
+    avoid trying to parse arguments, or you'll get into trouble.
+
 Reading the output
 ::::::::::::::::::