Update dev environment infos
@@ -200,45 +200,26 @@ script is located at the top level of the *source checkout* directory.
The ``setup.py`` script has two main modes of operation:
``python setup.py develop``
- Bokeh will be installed to refer to the source directory. Any changes
- you make to the python source code will be available immediately without
+ Bokeh will be installed to refer to your local source directory. Any changes
+ you make to the Python source code will be available immediately without
any additional steps. **This is the recommended mode when working on the
Bokeh codebase.**
``python setup.py install``
- Bokeh will be installed in your Python ``site-packages`` directory.
+ Bokeh will be installed in your local Python ``site-packages`` directory.
In this mode, any changes to the Python source code will have no effect
until you run ``setup.py install`` again.
-With either mode, Bokeh asks you how to install :term:`BokehJS`. For
-example:
-
-.. code-block:: sh
-
- python setup.py develop
-
- Bokeh includes a JavaScript library (BokehJS) that has its own
- build process. How would you like to handle BokehJS:
-
- 1) build and install fresh BokehJS
- 2) install last built BokehJS from bokeh/bokehjs/build
-
- Choice?
-
-Unless you know what you are doing, you should choose option 1 here. At the very
-least, you need to build BokehJS the first time you set up your local
-development environment.
-
-You can skip this prompt by supplying the appropriate command-line option
-to ``setup.py``. For example:
-
-* ``python setup.py develop --build-js``
-* ``python setup.py develop --install-js``
+Running either of those two commands also builds and installs a local version of
+:term:`BokehJS`. If you want to skip building a new version of BokehJS and use a
+different local version instead, use the ``--install-js`` flag:
+``python setup.py develop --install-js``
.. note::
You need to **rebuild BokehJS each time the BokehJS source code changes**.
- This can become necessary because you made changes yourself or because you
- pulled updated code from GitHub.
+ This can be necessary because you made changes yourself or because you
+ pulled updated code from GitHub. Re-run ``python setup.py develop`` to build
+ and install BokehJS.
Occasionally, the **list of JavaScript dependencies also changes**. If this
happens, you will need to re-run the instructions in the
@@ -251,7 +232,7 @@ to ``setup.py``. For example:
.. _contributor_guide_setup_sample_data:
-7. Download sample data
+1. Download sample data
-----------------------
Several tests and examples require Bokeh's sample data to be available on your
