Skip to content

docs: document v1.4 A2A context + complete docs site nav - #42

Merged
jaschadub merged 1 commit into
mainfrom
docs/v1.4-a2a-context-and-api-reference
Jun 23, 2026
Merged

docs: document v1.4 A2A context + complete docs site nav#42
jaschadub merged 1 commit into
mainfrom
docs/v1.4-a2a-context-and-api-reference

Conversation

@jaschadub

@jaschadub jaschadub commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Makes the docs/ directory complete and consistent with everything shipped in v1.4.

Gaps found and fixed

  1. A2A verification context (alpha.3) had no docs page — the only shipped v1.4 feature missing one. Added docs/a2a-context.md: AllowedDomains convention (empty = unrestricted), A2aVerificationContext fields, and verify_schema_for_a2a examples in all four languages.
  2. Site nav (zensical.toml) was missing every v1.4 feature page plus revocation — those pages existed but weren't navigable. All 13 pages are now in the nav.
  3. api-reference.md stopped at v1.3 — added a 'v1.4 Features' section indexing expiration, DNS TXT, version binding, canonicalization id, A2A context, and trust-bundle distribution.
  4. getting-started.md stale labels — expiration and DNS TXT were tagged '(Rust)' but shipped in all four languages; corrected, and added links to the version-binding / A2A / bundle-distribution pages.
  5. Cross-linked the v1.2 trust-bundles page to the new distribution page.

Verification

  • All 13 nav targets exist.
  • All internal .md links across docs/ resolve (no broken links).

Docs-only; no code changes.

- Add docs/a2a-context.md (alpha.3 A2A verification context) — the only
  shipped v1.4 feature without a docs page. Covers AllowedDomains convention,
  A2aVerificationContext, and verify_schema_for_a2a in all four languages.
- Fix zensical.toml site nav, which was missing every v1.4 feature page plus
  revocation; all 13 pages now navigable.
- Add a v1.4 Features section to api-reference.md (it previously stopped at
  v1.3) indexing expiration, DNS TXT, version binding, canonicalization id,
  A2A context, and trust-bundle distribution.
- getting-started: correct stale '(Rust)' labels to 'all 4 languages' for
  expiration/DNS TXT, and link the version-binding, A2A, and bundle-
  distribution pages.
- Cross-link the v1.2 trust-bundles page to trust-bundle-distribution.

All nav targets exist and all internal .md links resolve.
@jaschadub
jaschadub merged commit 0f45009 into main Jun 23, 2026
@jaschadub
jaschadub deleted the docs/v1.4-a2a-context-and-api-reference branch June 25, 2026 20:24
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