From 8fe85c22cee7fde5e6af571b30f864bad156a010 Mon Sep 17 00:00:00 2001
From: "Jason R. Coombs" <jaraco@jaraco.com>
Date: Sat, 3 Apr 2021 13:13:28 -0400
Subject: [PATCH] Officially declare pkg_resources as deprecated. Closes #2531.

---
 docs/pkg_resources.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/pkg_resources.rst b/docs/pkg_resources.rst
index 19d43244d1..994bea6f2b 100644
--- a/docs/pkg_resources.rst
+++ b/docs/pkg_resources.rst
@@ -10,6 +10,13 @@ eggs, support for merging packages that have separately-distributed modules or
 subpackages, and APIs for managing Python's current "working set" of active
 packages.
 
+Use of ``pkg_resources`` is discouraged in favor of
+`importlib.resources <https://docs.python.org/3/library/importlib.html#module-importlib.resources>`_,
+`importlib.metadata <https://docs.python.org/3/library/importlib.metadata.html>`_,
+and their backports (`resources <https://pypi.org/project/importlib_resources>`_,
+`metadata <https://pypi.org/project/importlib_metadata>`_).
+Please consider using those libraries instead of pkg_resources.
+
 
 .. contents:: **Table of Contents**