summaryrefslogtreecommitdiff
path: root/docs/html/development/getting-started.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/html/development/getting-started.rst')
-rw-r--r--docs/html/development/getting-started.rst24
1 files changed, 17 insertions, 7 deletions
diff --git a/docs/html/development/getting-started.rst b/docs/html/development/getting-started.rst
index 730f5ece0..e248259f0 100644
--- a/docs/html/development/getting-started.rst
+++ b/docs/html/development/getting-started.rst
@@ -27,23 +27,35 @@ Development Environment
pip is a command line application written in Python. For developing pip,
you should `install Python`_ on your computer.
-For developing pip, you need to install :pypi:`nox`. Often, you can run
-``python -m pip install nox`` to install and use it.
+For developing pip, you need to install :pypi:`nox`. The full development setup would then be:
+.. tab:: Unix/macOS
+
+ .. code-block:: shell
+
+ python -m venv .venv
+ source .venv/bin/activate
+ python -m pip install nox
+
+.. tab:: Windows
+
+ .. code-block:: shell
+
+ py -m venv .venv
+ .venv\Scripts\activate
+ py -m pip install nox
Running pip From Source Tree
============================
To run the pip executable from your source tree during development, install pip
locally using editable installation (inside a virtualenv).
-You can then invoke your local source tree pip normally.
+You can then invoke your local source tree pip normally (be sure virtualenv is active).
.. tab:: Unix/macOS
.. code-block:: shell
- python -m venv .venv
- source .venv/bin/activate
python -m pip install -e .
python -m pip --version
@@ -51,8 +63,6 @@ You can then invoke your local source tree pip normally.
.. code-block:: shell
- py -m venv .venv
- .venv\Scripts\activate
py -m pip install -e .
py -m pip --version