Add information on why namespace_packages are deprecated

pypa · Feb 13, 2023 · 81e1137 · 81e1137
1 parent 7066963
commit 81e1137
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/docs/references/keywords.rst b/docs/references/keywords.rst
@@ -390,7 +390,10 @@ extensions).
 
 ``namespace_packages``
     .. warning::
-        ``namespace_packages`` is deprecated in favor of native/implicit
+        The ``namespace_packages`` implementation relies on ``pkg_resources``.
+        However, ``pkg_resources`` has some undesirable behaviours, and
+        Setuptools intends to obviate its usage in the future. Therefore,
+        ``namespace_packages`` was deprecated in favor of native/implicit
         namespaces (:pep:`420`). Check :doc:`the Python Packaging User Guide
         <PyPUG:guides/packaging-namespace-packages>` for more information.