Backfill standalone documents for protocol 0.1 and 0.2 - #8
Merged
Conversation
Each prior protocol version now has a spec of record alongside the frozen v0.3 spec.md, derived by removing clauses tagged above the target version. Section numbering matches spec.md (later-version sections stubbed with pointers); normative content remains defined exclusively in spec.md. Also corrects the README's stale 'v0.3 — draft' status to 'frozen'.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds
versions/with a standalone document of record per prior protocol version, alongside the frozen v0.3spec.md:versions/spec-v0.1.md— protocol 0.1 (initial; approvals fingerprint-bound only)versions/spec-v0.2.md— protocol 0.2 (what the referencedelego0.2.x implements today)versions/README.md— index + derivation/maintenance rulesAlso links them from the README's Status & versioning section (and corrects its stale "v0.3 — draft" status to "frozen"), and records the change under
[Unreleased]in the changelog as editorial.Why
spec.mdis frozen at 0.3 and tags clauses inline ((since 0.2), (0.3, draft …)). An implementation declaring 0.1 or 0.2 (delego.__protocol_version__is"0.2") had no readable spec of record without filtering those tags by hand.How the snapshots were produced
Derived from the frozen v0.3 document by removing every clause tagged above the target version — not resurrected from git history: no standalone 0.2 doc ever existed, and the original 0.1 draft carries the since-corrected §8.1 truncation claim and pre-genericization examples. Each snapshot's banner states it was backfilled retroactively and points to git history for the originals.
Notable choices:
spec.md.engine.pyresolve guards,audit.pyverify).No protocol change
spec.mdis untouched; normative content remains defined exclusively there. CI is unaffected (validate.pychecks JSON vectors only).