Align the docs with the implementation, and centralise references on Reference:: - #22

Merged

tymondesigns merged 13 commits into

mainfrom

cursor/align-openapi-docs-6953

Sep 16, 2026

Commits on Sep 16, 2026

docs: align OpenAPI pages with current builder APIs

cursoragent
and
tymondesigns
committed
8089f18
docs: describe json-schema 1.3.0 embedding, not unreleased APIs

cursoragent
and
tymondesigns
committed
7cc8db6
docs: fix Schema::ref wording and README validation note

cursoragent
and
tymondesigns
committed
4c3ca61
fix: strip the JSON Schema $schema URI from nested embedded schemas

cursoragent
and
tymondesigns
committed
b9f0a09
docs: add the missing Validation & Output page

cursoragent
and
tymondesigns
committed
1df16ea
docs: rewrite the reworked passages around what to do, not what breaks

cursoragent
and
tymondesigns
committed
70c211d
test: cover the contains leak and cite the spec rule for stripping $schema

cursoragent
and
tymondesigns
committed
ead449c
docs: use Response::ref() consistently in response() samples

cursoragent
and
tymondesigns
committed
94d6cad
Centralise references on Reference::, and let Response::ref() be the fluent form (#23)

tymondesigns
and
cursoragent
authored
4789fcb
Merge main (php 8.4, pest 5, json-schema 2) into docs branch

cursoragent
and
tymondesigns
committed
4a3822e
test: pin the $schema tests to our contract, not upstream's bug

cursoragent
and
tymondesigns
committed
51c3583
fix: only walk schema-bearing keywords when stripping $schema

cursoragent
and
tymondesigns
committed
1206f13
fix: skip instance-valued keywords instead of allowlisting schema ones

cursoragent
and
tymondesigns
committed
1a81c5a