diff --git a/docs/extension/jupyter.rst b/docs/extension/jupyter.rst index 75328a3..b702793 100644 --- a/docs/extension/jupyter.rst +++ b/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:: diff --git a/docs/guide/purity.rst b/docs/guide/purity.rst index df932a4..edfd930 100644 --- a/docs/guide/purity.rst +++ b/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 { diff --git a/docs/tutorial/1-init.rst b/docs/tutorial/1-init.rst index 1668417..03b00c4 100644 --- a/docs/tutorial/1-init.rst +++ b/docs/tutorial/1-init.rst @@ -59,6 +59,8 @@ To inspect the graph of your first transformation: You must `install the graphviz software first `_. 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 ::::::::::::::::::