From d9dd2c8cc0ee2bc7a4191dc0e8c8c9b59d795185 Mon Sep 17 00:00:00 2001
From: Donald Stufft <donald@stufft.io>
Date: Thu, 7 Jul 2022 11:44:56 -0400
Subject: [PATCH] Deprecate the releases key on the non version json too

---
 docs/api-reference/json.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/api-reference/json.rst b/docs/api-reference/json.rst
index 3e97c4e53e3f..f1aeab4a5e80 100644
--- a/docs/api-reference/json.rst
+++ b/docs/api-reference/json.rst
@@ -6,6 +6,14 @@ PyPI offers two JSON endpoints.
 Project
 -------
 
+.. attention::
+    The ``releases`` key on this response should be considered deprecated,
+    and projects should shift to using the simple API (which can be accessed
+    as JSON via PEP 691) to get this information where possible.
+
+    In the future, the ``releases`` key may be removed from this response.
+
+
 .. http:get:: /pypi/<project_name>/json
 
     Returns metadata (info) about an individual project at the latest version,