Skip to content

docs: prepare the README and notes for the v0.2.0 final - #671

Merged
ion-alpha-dev merged 1 commit into
mainfrom
docs/v0.2.0-final
Nov 5, 2026
Merged

ion-alpha-dev merged 1 commit into
mainfrom
docs/v0.2.0-final

Conversation

@ion-alpha-dev

Copy link
Copy Markdown
Collaborator

What

Rewrites the README's install section and the v0.2.0 notes for the final release: the install example pins v0.2.0, the paragraphs that called main a release candidate and pointed at v0.2.0-rc.1 are gone, and the notes gain two known limitations.

Why

v0.2.0-rc.2 is soaking and the final will be tagged from main. The release workflow publishes docs/releases/v0.2.0.md as the release body, so the notes and README must read correctly for the final before the tag is pushed.

How to verify

  • git grep -n "0.2.0-rc" lists only intentional examples (the release workflow comment, dev/upgrade-check usage, docs/releases/README.md, and the deploy/README.md note for units installed from rc.1).
  • Read the README's Install section and the notes' "Upgrading from v0.1.3" and "Known limitations" sections.

Notes for reviewers

  • The general "Testing a release candidate?" block stays in the README, since it applies to every future candidate.
  • The "v0.1.3 cannot read a data directory v0.2.0 wrote" warning moved from the removed candidate section to "Upgrading from v0.1.3".
  • New known limitations: a goal planner can write an acceptance check for a file outside the working directory, which the sandbox refuses, so the goal fails (seen in a live sandbox test on Windows, and intermittent); and scanners that match by module version report GO-2026-5932 in golang.org/x/crypto, which Flynn does not import.
  • docs/UPGRADE.md and docs/VERSIONING.md needed no change: UPGRADE's sample is recorded output from a real v0.1.3 upgrade, and VERSIONING names no release.
  • Do not merge until the decision to tag v0.2.0 is made.

The README told readers that main was a release candidate and pinned
its install examples to v0.2.0-rc.1, and the notes had a section on
installing a candidate that only makes sense before the final ships.

The README now pins v0.2.0 in its example and points v0.1.3 users at
flynn upgrade and the upgrade notes. The rc-only paragraphs are gone.
The general instructions for testing a future candidate stay.

The notes keep the one fact from the candidate section that still
applies (v0.1.3 cannot read a data directory v0.2.0 wrote) under
Upgrading, and add two known limitations: a planner that writes a check
for a file outside the working directory, which the sandbox then
refuses, and the GO-2026-5932 report from scanners that match by module
version, with why Flynn does not reach the affected packages.

Signed-off-by: Ion Alpha <contact@ionalpha.io>
@codecov

codecov Bot commented Nov 4, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@ion-alpha-dev
ion-alpha-dev merged commit cfbbb32 into main Nov 5, 2026
84 of 90 checks passed
@ion-alpha-dev
ion-alpha-dev deleted the docs/v0.2.0-final branch November 5, 2026 08:33
@github-actions github-actions Bot locked and limited conversation to collaborators Nov 5, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant