docs: Update pkg_resources deprecation warnings

Signed-off-by: Stephen Finucane <stephen@that.guru>

Author: stephenfin

docs/deprecated/pkg_resources.rst

@@ -14,11 +14,17 @@ Package Discovery and Resource Access using ``pkg_resources``
       ``pkg_resources`` issued official deprecation warnings as early as
       ``setuptools`` **v67.5.0**.
 
-   .. version-removed:: v82.0.0
+   .. version-changed:: v82.0.0
       ``pkg_resources`` is no longer maintained, no longer used internally by
       ``setuptools``, and is no longer included in current
       distributions/installations as of ``setuptools`` **v82.0.0**.
 
+   .. version-changed:: 83.0.0
+      ``pkg_resources`` is reintroduced but remains deprecated and should not
+      be used by new project. Existing projects should continue to migrate
+      away from it, as discussed below. No new features or bugfixes will be
+      accepted for this package.
+
    Projects must migrate away from ``pkg_resources``. The recommended
    replacements are:
 

newsfragments/5174.bugfix.rst

@@ -0,0 +1,4 @@
+The ``pkg_resources`` package has been restored. It remains deprecated and
+should not be used for new packages. Existing users should migrate to a
+replacement as soon as possible. No new features or bug fixes will be accepted
+for this package.

pkg_resources/README.rst

@@ -0,0 +1,11 @@
+``pkg_resources``
+=================
+
+.. warning::
+
+   ``pkg_resources`` is considered deprecated and frozen. No new features or
+   bug fixes will be accepted for this package.
+
+The legacy ``pkg_resources``. For more information, see `the documentation`__.
+
+.. __: https://setuptools.pypa.io/en/latest/deprecated/pkg_resources.html