Changelog & Versioning
This page tracks releases of the GitBook and explains how disparate source drafts map into the unified Freeze–Vote–Rebuild structure.
Versioning Scheme
We use semantic versioning to track the evolution of the framework:
- MAJOR (v1.0.0): Structural changes (navigation, chapter layout, scope changes).
- MINOR (v0.1.0): Significant content additions or policy/operational refinements.
- PATCH (v0.0.1): Typo fixes, wording clarifications, and formatting updates.
Source Documents and Mapping
This GitBook consolidates multiple inputs into a single maintained structure to ensure consistency across technical and political audiences:
- Comprehensive Proposal (Neutral, Verification-First): Broad narrative and concept framing across Freeze/Vote/Rebuild.
- “v4—Operational Peace Framework”: Implementation-oriented: sequencing, action items, legal/approval gating, and operational details.
- “McCormick-style Off-ramp” Essay: Persuasive framing aimed at US realist audiences; narrative-style argumentation.
- “Projet du Pape François…” (French variant): Alternate origin/variant framing and rhetorical positioning.
Unified Structure Logic:
- Chapters 02–04: The Core Mechanism (Freeze/Vote/Rebuild).
- Chapters 05–06: Cross-cutting Verification + Legal Pathways.
- Chapter 10: Essays/Variants (kept separate from the core mechanism).
- Chapter 11: Archive of source texts to maintain traceability.
Change Control Workflow
When updating the GitBook, the following workflow is recommended:
- Document Rationale: Make substantive design changes and document the reasoning in the Decision Log.
- Release Entry: Record the release version and date here under GitBook Releases.
- Delta Tracking: If a change alters how previous drafts are interpreted, update the Deltas Between Versions.
GitBook Releases
v1.0.0 (Current - Dec 2025)
- Initial Scaffold: File tree, navigation, and reader pathways established.
- Core Content Extraction: Content extracted from source drafts for Freeze, Vote, and Rebuild phases.
- Governance & Legal: Initial "Verification-First Gates" and "Domestic Approvals" logic populated.
- Risk Management: Initial Risk Register and Failure Modes cataloged.
v0.5.0 (Alpha)
- Initial scaffold created with placeholders.
- Source-text archive populated with reference-only originals.
Conventions and Flags
Use these markers within pages while drafting to maintain transparency:
- [TBD] — Requires content drafting or data.
- [ASSUMPTION] — Relies on a premise that should be made explicit and testable.
- [RISK] — Introduces or depends on a non-trivial failure mode.
- [OPEN QUESTION] — Requires stakeholder input or empirical validation.
- [SOURCE NOTE] — Indicates which source draft introduced the idea for traceability.
Attribution and Licensing
- Document Maintainer: [Insert Lead Organization/Author]
- Licensing: [Insert Creative Commons or Proprietary Terms]
- Citation Guidance: When referencing this framework, please cite the specific version number and date found in this changelog.
