diff --git a/doc/contributing.texi b/doc/contributing.texi index 4b1eed1cb1..17dd4ec7a9 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -786,6 +786,24 @@ for instance, the module python-dateutil is packaged under the names starts with @code{py} (e.g.@: @code{pytz}), we keep it and prefix it as described above. +@quotation Note +Instead of the default Python build system @var{python-build-system} +(@pxref{Build Systems}), we are encouraging to try the ``experimental'' +@var{pyproject-build-system} exported by @code{guix build-system +pyproject}. It is a reimplementation of @var{python-build-system} +designed around @file{pyproject.toml} and +@url{https://peps.python.org/pep-0517/, PEP 517}, and it supports a +variety of build backends and test frameworks. + +It is considered ``experimental'' in that the implementation details are +not set in stone yet. However, there should not be any breaking +changes, so please report any failure for new Python packages (even +those using @file{setup.py}). + +Eventually this @var{pyproject-build-system} will be deprecated and +merged back into @var{python-build-system}, probably some time in 2024. +@end quotation + @subsubsection Specifying Dependencies @cindex inputs, for Python packages