Skip to content

docs: explain release decisions with executable examples - #6

Merged
noetion merged 1 commit into
mainfrom
docs/release-decision-examples
Sep 29, 2026
Merged

noetion merged 1 commit into
mainfrom
docs/release-decision-examples

Conversation

@noetion

@noetion noetion commented Sep 29, 2026

Copy link
Copy Markdown
Owner

Purpose

Explain the release gate's purpose and make its decision paths directly inspectable.

Changes

  • Show the fictional example's actual CLI output and simulation exit code.
  • Explain rejection without the simulation flag and name its blocking reasons.
  • Link to gate tests, CLI, example evidence, and operating guidance.
  • Refresh the README checksum in the release manifest.

Verification

  • 72 unit tests passed against the committed wheel.
  • Executed the example with and without --allow-fictional; confirmed simulation and rejection.
  • Release manifest check passed; git diff --check passed.

Review scope and limitations

Documentation and its integrity manifest only. Review the example against the CLI output and confirm the manifest changes only the README digest. Gate logic, packaged wheel, and trust boundaries are unchanged. Fictional evidence cannot authorize deployment.

@noetion

noetion commented Sep 29, 2026

Copy link
Copy Markdown
Owner Author

Reviewed c77c540: no blocking findings in the documentation diff. Confirmed both CLI decision paths against the installed release wheel, 72 passing unit tests, the regenerated release manifest, and rendered README examples/table. GitHub CI passed on Python 3.11 and 3.13 for both push and pull-request runs. Only README.md and its manifest digest changed; no release-gate behavior or deployment-authority claim was added.

@noetion
noetion merged commit 8cca073 into main Sep 29, 2026
4 checks passed
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