summaryrefslogtreecommitdiff
path: root/docs/userguide
diff options
context:
space:
mode:
Diffstat (limited to 'docs/userguide')
-rw-r--r--docs/userguide/index.rst9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
index abee331a..8470e268 100644
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -10,6 +10,15 @@ packages.
Packages built and distributed using ``setuptools`` look to the user like
ordinary Python packages based on the ``distutils``.
+Transition to PEP517
+====================
+
+Since setuptools no longer serves as the default build tool, one must explicitly
+opt in (by providing a ``pyproject.toml`` file) to use this library. The user
+facing part is provided by `PEP517 <https://pypi.org/project/pep517/>`_ and
+backend interface is described :ref:`in this document <../build_meta>`. The
+quickstart provides an overview of the new workflow.
+
.. toctree::
:maxdepth: 1