diff --git a/docs/src/installing.rst b/docs/src/installing.rst
index 74e349a518..cff9a27952 100644
--- a/docs/src/installing.rst
+++ b/docs/src/installing.rst
@@ -107,10 +107,10 @@ all the packages from the `testing` and `documentation` sections.
 
 .. _requirements: https://github.com/scitools/iris/tree/main/requirements
 
-Finally you need to run the command to configure your shell environment
-to find your local Iris code::
+Finally you need to run the command to configure your environment
+to find your local Iris code.  From your Iris directory run::
 
-  python setup.py develop
+  pip install --no-deps --editable .
 
 
 Running the Tests
diff --git a/docs/src/whatsnew/latest.rst b/docs/src/whatsnew/latest.rst
index 2b7b0f13d4..aeeb125916 100644
--- a/docs/src/whatsnew/latest.rst
+++ b/docs/src/whatsnew/latest.rst
@@ -67,7 +67,7 @@ This document explains the changes made to Iris for this release
    3.11. (:pull:`5226`)
 
 #. `@rcomer`_ dropped support for python 3.8, in accordance with the NEP29_
-   recommendations (:pull:`5226`) 
+   recommendations (:pull:`5226`)
 
 
 📚 Documentation
@@ -80,6 +80,9 @@ This document explains the changes made to Iris for this release
    ``livehtml`` to auto generate the documentation when changes are detected
    during development. (:pull:`5258`)
 
+#. `@tkknight`_ updated the :ref:`installing_from_source` instructions to use
+   ``pip``.  (:pull:`5273`)
+
 
 💼 Internal
 ===========