Skip to content

docs: 1.4.7 release notes, vendor-global decision, architecture pages#22

Merged
lesnik512 merged 3 commits into
mainfrom
docs/release-notes-and-architecture
Jul 4, 2026
Merged

docs: 1.4.7 release notes, vendor-global decision, architecture pages#22
lesnik512 merged 3 commits into
mainfrom
docs/release-notes-and-architecture

Conversation

@lesnik512

Copy link
Copy Markdown
Member

Documentation close-out after the two architecture reviews. No code changes.

1. Release notes — planning/releases/1.4.7.md

Drafts 1.4.7 (patch). Headline: the case-insensitive vendor matching fix (#18) — a mixed-case configured vendor previously never matched and silently fell back to v1.0. Also lists the internal refactors (#17, #21). No API changes, so downstream needs no action. The tag/publish is yours to cut — this only stages the note (versioning is tag-driven).

2. Decision — planning/decisions/2026-07-04-vendor-media-type-stays-process-global.md

Records review #2's candidate B (vendor as process-global class state) as rejected, closing that review's loop so it isn't re-suggested. Rationale: instance-scoping collides with the response-class mechanism kept by the ClassProperty decision, and one-vendor-per-process is an accepted, documented constraint. Includes a revisit trigger (needing two different vendors in one process).

3. Architecture pages — architecture/

Seeds the living-truth home, which until now held only its README:

  • glossary.md — the ubiquitous language (Vendor media type, Version, Versioned route, …).
  • accept-header-version-negotiation.md — the parse → match → respond flow across accept.py / router.py.
  • openapi-schema-versioning.md_iter_openapi_routes + _collapse_versioned_paths and why only request bodies are rewritten.

Both pages cross-reference the three decision records for the deliberate constraints.

just check-planningplanning: OK; just lint-ci clean.

🤖 Generated with Claude Code

lesnik512 and others added 3 commits July 4, 2026 15:57
Case-insensitive vendor matching fix (#18) plus internal refactors (#17, #21) since 1.4.6.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Review #2 candidate B: keep VENDOR_MEDIA_TYPE as class-global state; instance-scoping collides with the response-class mechanism and one-vendor-per-process is accepted.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Living-truth pages for Accept-header version negotiation and OpenAPI schema versioning, plus the ubiquitous-language glossary.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit 72fa1a6 into main Jul 4, 2026
6 checks passed
@lesnik512 lesnik512 deleted the docs/release-notes-and-architecture branch July 4, 2026 12:59
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