docs: migrate RSS Feed docs to user docs (pypi#17171)

* docs: migrate RSS Feed docs to user docs

Signed-off-by: William Woodruff <william@trailofbits.com>

* dev-docs: move XMLRPC docs

Signed-off-by: William Woodruff <william@trailofbits.com>

---------

Signed-off-by: William Woodruff <william@trailofbits.com>

docs/dev/api-reference/feeds.rst

@@ -1,69 +1,9 @@
 Feeds
 =====
 
-PyPI offers three RSS feeds, the `Newest Packages Feed`_, the `Latest Updates
-Feed`_, and the `Project Releases Feed`_. You can also call its APIs to get
-more details on project activity.
+.. important::
 
+  This API documentation has been migrated to a new page in
+  the `user documentation <https://docs.pypi.org/>`_:
 
-Newest Packages Feed
---------------------
-
-Available at https://pypi.org/rss/packages.xml, this feed provides the latest
-newly created projects on PyPI, including the package name, description and a
-link to the project page.
-
-
-Latest Updates Feed
--------------------
-
-Available at https://pypi.org/rss/updates.xml, this feed provides the latest
-newly created releases for individual projects on PyPI, including the project
-name and description, release version, and a link to the release page.
-
-
-Project Releases Feed
----------------------
-
-Available at ``https://pypi.org/rss/project/<project_name>/releases.xml`` for each
-project, this feed provides the latest releases for the given project on
-PyPI, including the package name and description, release version, and a link
-to the release page.
-
-
-Project and release activity details
-------------------------------------
-
-PyPI publishes a "journal" of all project, package, and release
-activity (including Owner and Maintainer additions and removals, and
-source file and release additions and removals). You can query it with
-a mix of :ref:`changelog-since` and the
-`index API <https://docs.pypi.org/api/index-api/>`_. Call
-``changelog_last_serial()`` (in :doc:`xml-rpc`) to get the current
-revision of the journal (the last event's serial ID), then look at
-``/simple/`` to get a list of all packages that currently
-exist. Subsequently, you can call
-``changelog_since_serial(since_serial)`` with the serial ID you
-retrieved, and get the list of all actions that have occurred since
-then.
-
-Example usage::
-
-  >>> import time
-  >>> import xmlrpc.client
-  >>> client = xmlrpc.client.ServerProxy("https://test.pypi.org/pypi")
-  >>> serial = client.changelog_last_serial()
-  >>> serial
-  4601224
-  >>> while serial == client.changelog_last_serial():
-  ...     time.sleep(5)
-  >>> recentchanges = client.changelog_since_serial(serial)
-  >>> for entry in recentchanges:
-  ...     print(entry)
-  ['openllm', '0.4.33.dev3', 1701280908, 'new release', 4601225]
-  ['openllm', '0.4.33.dev3', 1701280908, 'add py3 file openllm-0.4.33.dev3-py3-none-any.whl', 4601226]
-
-You could also request ``GET /simple/``, and record the ``ETag``, and
-then periodically do a conditional HTTP GET to ``/simple/`` with that
-ETag included. A 200 OK response indicates something has been added or
-removed; if you get a 304 Not Modified, then nothing has changed.
+  * `RSS Feeds <https://docs.pypi.org/api/feeds/>`_

docs/dev/api-reference/xml-rpc.rst

@@ -35,6 +35,43 @@ Example usage (Python 3)::
    '0.618': 14863648,
   ...
 
+Project and release activity details
+------------------------------------
+
+PyPI publishes a "journal" of all project, package, and release
+activity (including Owner and Maintainer additions and removals, and
+source file and release additions and removals). You can query it with
+a mix of :ref:`changelog-since` and the
+`index API <https://docs.pypi.org/api/index-api/>`_. Call
+``changelog_last_serial()`` to get the current
+revision of the journal (the last event's serial ID), then look at
+``/simple/`` to get a list of all packages that currently
+exist. Subsequently, you can call
+``changelog_since_serial(since_serial)`` with the serial ID you
+retrieved, and get the list of all actions that have occurred since
+then.
+
+Example usage::
+
+  >>> import time
+  >>> import xmlrpc.client
+  >>> client = xmlrpc.client.ServerProxy("https://test.pypi.org/pypi")
+  >>> serial = client.changelog_last_serial()
+  >>> serial
+  4601224
+  >>> while serial == client.changelog_last_serial():
+  ...     time.sleep(5)
+  >>> recentchanges = client.changelog_since_serial(serial)
+  >>> for entry in recentchanges:
+  ...     print(entry)
+  ['openllm', '0.4.33.dev3', 1701280908, 'new release', 4601225]
+  ['openllm', '0.4.33.dev3', 1701280908, 'add py3 file openllm-0.4.33.dev3-py3-none-any.whl', 4601226]
+
+You could also request ``GET /simple/``, and record the ``ETag``, and
+then periodically do a conditional HTTP GET to ``/simple/`` with that
+ETag included. A 200 OK response indicates something has been added or
+removed; if you get a 304 Not Modified, then nothing has changed.
+
 .. _changes-to-legacy-api:
 
 Changes to XMLRPC API

docs/mkdocs-user-docs.yml

@@ -93,3 +93,4 @@ nav:
       - "api/integrity.md"
       - "api/stats.md"
       - "api/bigquery.md"
+      - "api/feeds.md"

docs/user/api/feeds.md

@@ -0,0 +1,27 @@
+# RSS Feeds
+
+PyPI offers three RSS feeds: the Newest Packages Feed, the Latest Updates
+Feed, and the Project Releases Feed.
+
+## Newest Packages Feed
+
+*Feed URL:* <https://pypi.org/rss/packages.xml>
+
+This feed provides the latest newly created projects on PyPI, including the
+package name, description and a link to the project page.
+
+## Latest Updates Feed
+
+*Feed URL:* <https://pypi.org/rss/updates.xml>
+
+This feed provides the latest newly created releases for individual projects on
+PyPI, including the project name and description, release version, and a link
+to the release page.
+
+## Project Releases Feed
+
+*Feed URL:* `https://pypi.org/rss/project/<project_name>/releases.xml`
+
+Available for each project, this feed provides the latest releases for the
+given project on PyPI, including the package name and description, release
+version, and a link to the release page.