From 94daba8d084549611eaa8880197482cdafdac089 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 15 Jul 2024 23:32:06 -0600
Subject: [PATCH] Add a pseudo-schema

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
---
 peps/api/index.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/peps/api/index.rst b/peps/api/index.rst
index f649c23800c..6750219b02e 100644
--- a/peps/api/index.rst
+++ b/peps/api/index.rst
@@ -7,6 +7,32 @@ There is a read-only API of published PEPs available at:
 
 The structure is like:
 
+.. code-block:: json
+
+   {
+     "<PEP number>": {
+       "number": integer,
+       "title": string,
+       "authors": string,
+       "discussions_to": string | null,
+       "status": "Accepted" | "Active" | "Deferred" | "Draft" | "Final" | "Provisional" | "Rejected" | "Superseded" | "Withdrawn",
+       "type": "Informational" | "Process" | "Standards Track",
+       "topic": "governance" | "packaging" | "release" | "typing" | "",
+       "created": string,
+       "python_version": string | null,
+       "post_history": string,
+       "resolution": string | null,
+       "requires": string | null,
+       "replaces": string | null,
+       "superseded_by": string | null,
+       "url": string
+     },
+
+Date values are formatted as DD-MMM-YYYY,
+and multiple dates are combied in a comma-separated list.
+
+For example:
+
 .. code-block:: json
 
    {