From 50b9d961266097652e88e96c502328161e43cd05 Mon Sep 17 00:00:00 2001
From: bensynapse <118375461+bensynapse@users.noreply.github.com>
Date: Thu, 12 Nov 2026 23:32:20 +0200
Subject: [PATCH] Say which earlier schemas the saved spec no longer keeps

The README said the saved spec keeps every earlier schema.
0.5.0 removed the two validation error schemas.
---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index ae3b4e4..b63b361 100644
--- a/README.md
+++ b/README.md
@@ -300,6 +300,7 @@ sh scripts/truthcheck.sh
 ```
 
 `spec/openapi.yaml` follows the public document at API version 1.18.0 and keeps the schemas of the earlier live documents.
+The two validation error schemas are the exception. 0.5.0 removed them because the server never sent that shape.
 It also retains earlier public model names and route-documented response additions.
 To refresh it, merge the live schemas while preserving existing declarations, then run `uv run python scripts/gen_models.py`.
 Keep new response fields optional so older payloads and existing callers remain valid.