Skip to content

docs(cookbook): CI validation and pin guidance - #8

Merged
gitpash merged 1 commit into
mainfrom
docs/t5-ci-validation
Oct 17, 2026
Merged

gitpash merged 1 commit into
mainfrom
docs/t5-ci-validation

Conversation

@gitpash

@gitpash gitpash commented Oct 16, 2026

Copy link
Copy Markdown
Owner

Summary

T5 cookbook page for CI validation of consumer maps against a pinned protocol revision (git tag or commit SHA).

  • How to run / adapt checks around scripts/validate.py and pinned schemas/map.schema.json
  • Explicit warning: mutable Gist URL or unpinned main can silently change CI behavior
  • Minimal generic CI step example (not locked to one vendor)
  • Links schema-pinning.md; one-line links from README + schema-pinning see-also
  • No schema/version/tag move

Test plan

  • python scripts/validate.py (venv) — all checks passed
  • CI on this PR green

Add cookbook/ci-validation.md for running pinned schema checks on
consumer maps in CI, with explicit warnings against floating main/Gist
tips. Link from README profiles table and schema-pinning see-also.
@gitpash gitpash self-assigned this Oct 17, 2026
@gitpash
gitpash merged commit 8b14484 into main Oct 17, 2026
1 check passed
@gitpash
gitpash deleted the docs/t5-ci-validation branch October 17, 2026 05:18
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