docs: name jsonschema where the build needs it

tests/test_workflow_paths.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 
 import ast
 import fnmatch
+import sys
 import unittest
 from pathlib import Path
 
@@ -85,5 +86,19 @@ class DeploySiteTriggers(unittest.TestCase):
         self.assertEqual(uncovered, [])
 
 
+class DocumentedSteps(unittest.TestCase):
+    def test_the_release_page_names_every_installed_package(self):
+        """The page listed pyyaml and mkdocs and left out jsonschema: a
+        maintainer following it could not run the contract check."""
+        sys.path.insert(0, str(SCRIPTS))
+        from check_freshness import parse_pip_pins  # noqa: PLC0415
+
+        workflow = (REPO_ROOT / ".github/workflows/deploy-site.yml").read_text(encoding="utf-8")
+        page = (REPO_ROOT / "wiki/release-process.md").read_text(encoding="utf-8")
+        missing = sorted(name for name in parse_pip_pins(workflow) if name not in page)
+        self.assertEqual(missing, [])
+        self.assertIn("validate_schemas.py", page)
+
+
 if __name__ == "__main__":
     unittest.main()