Document that pip works with editable setup.cfg

2 files changed, 11 insertions, 9 deletions

diff --git a/docs/conf.py b/docs/conf.py
index ebb84c48..d352a481 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -171,3 +171,5 @@ towncrier_draft_working_directory = '..'
 towncrier_draft_include_empty = False
 
 extensions += ['jaraco.tidelift']
+
+intersphinx_mapping['pip'] = 'https://pip.pypa.io/en/latest', None
diff --git a/docs/userguide/quickstart.rst b/docs/userguide/quickstart.rst
index bcb282ed..9c1d84f9 100644
--- a/docs/userguide/quickstart.rst
+++ b/docs/userguide/quickstart.rst
@@ -186,17 +186,17 @@ For more details, see :doc:`datafiles`
 
 Development mode
 ================
-``setuptools`` allows you to install a package without copying any files
-to your interpreter directory (e.g. the ``site-packages`` directory). This
-allows you to modify your source code and have the changes take effect without
-you having to rebuild and reinstall. This is currently incompatible with
-PEP 517 and therefore it requires a ``setup.py`` script with the following
-content::
 
-    import setuptools
-    setuptools.setup()
+.. tip::
+
+	When there is no ``setup.py`` script present, this is only
+	compatible with :pep:`517` since :ref:`pip v21.1 <pip:v21-1>`.
 
-Then::
+``setuptools`` allows you to install a package without copying any files
+to your interpreter directory (e.g. the ``site-packages`` directory).
+This allows you to modify your source code and have the changes take
+effect without you having to rebuild and reinstall.
+Here's how to do it::
 
     pip install --editable .