Skip to content

fix: update all broken schema references in documentation#160

Open
wry-ry wants to merge 9 commits intoUniversal-Commerce-Protocol:mainfrom
wry-ry:main
Open

fix: update all broken schema references in documentation#160
wry-ry wants to merge 9 commits intoUniversal-Commerce-Protocol:mainfrom
wry-ry:main

Conversation

@wry-ry
Copy link
Collaborator

@wry-ry wry-ry commented Feb 6, 2026

Description

This fix updates the broken schema references in the documentation. Additionally, the documentation generation will now throw an error when it encounters a schema reference issue instead of just adding error text directly into the doc.

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • Documentation update

…cp/main.py`

- Update `extension_fields` to dynamically locate extension definitions by inspecting `allOf` properties instead of relying on hardcoded keys like "checkout". This fixes `RuntimeError` when rendering extensions using namespaced keys (e.g., `dev.ucp.shopping.checkout`).
- Update `_render_embedded_table` to handle resolved schema objects in `capability.json` processing. This fixes `ValueError` caused by attempting to construct reference strings from already-resolved schema dictionaries
- Chain exceptions with `from e` or `from None` in `raise` statements across `main.py` to satisfy Ruff rule B904 and improve error traceback clarity.
@wry-ry wry-ry requested a review from a team February 6, 2026 22:56
Updates macro calls in documentation to point to the correct 'rest.openapi.json' file instead of the missing 'openapi.json', resolving RuntimeError during site generation.
Fixes 403 Forbidden error when Super-Linter attempts to post comments on Pull Requests.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant