Skip to content

docs(release): prepare 2.6.4: notes, test plan, version, translations - #705

Draft
brickbots wants to merge 6 commits into
mainfrom
release-2.6.4-prep
Draft

brickbots wants to merge 6 commits into
mainfrom
release-2.6.4-prep

Conversation

@brickbots

Copy link
Copy Markdown
Owner

This PR prepares the 2.6.4 release. It adds the release notes and the test plan, sets the version to 2.6.4, translates the new screen text, and links the 2.6.3 manual. It does not change how the PiFinder works.

Merge it before the cut. The cut itself (main into release, the tag) is a separate step.

What this PR changes

  • version.txt is now 2.6.4. Devices read this file from release, so nothing is offered until the cut.
  • release_notes/2.6.4.md: the long release notes, for everything since the v2.6.3 tag. The catalog changes are one item that links release_notes/2.6.4-catalog.md (from data(catalog): rebuild the catalog database with the catalog-audit fixes (#670) — squash-merge only #697). The notes do not mention the NixOS migration. Testers get their own instructions.
  • release_notes/release-2.6.4-test-plan.md: gates 1 to 6 from the release playbook, in order of risk. Gate 1 is complete. Gates 2 to 5 need hardware.
  • Translations (de, es, fr, zh): 698 messages each, with 0 fuzzy and 0 untranslated.
    • Five new strings: Named Stars, and four on the Software screen. They are marked AI-TRANSLATED for review.
    • Enter Local Time is translated again. The 2.6.3 catalogs marked it obsolete, so 2.6.3 showed it in English.
    • Exposure and Power + WiFi req are no longer in the code, so they are now obsolete.
  • noxfile.py: the babel session installs setuptools<81. Babel 2.16 on Python 3.9 needs pkg_resources to find the jinja2 extractor, and setuptools 81 removed it. Without the pin, a new venv fails with "Unknown extraction method 'jinja2'".
  • Docs: the "previous versions" note in index.rst, user_guide.rst and quick_start.rst now lists 2.0.x, 2.1.x and 2.6.3. The 1.x link is removed, as the playbook says (add the previous release, remove the oldest). All of these links resolve.

Gate 1 (at b709c6f5a, main)

Check Result
Ruff lint and format clean, 290 files
MyPy, clean cache clean, 158 source files
Smoke and unit tests 2,421 pass (1,531 at 2.6.3)
UI tests 225 pass, 2 skipped, 1 min 47 s
Sphinx -nW clean, 20 pages
i18n 698 × 4, 0 fuzzy, 0 untranslated, each .mo the same as a new compile

test_black_level.py has no pytest marker, so no nox session runs it. Its 14 tests pass when you run them directly. This is a follow-up, not a blocker.

Pre-flight (release playbook, phase 2)

  • release ← main merges with no conflicts, and the result is the same tree as main (git merge-tree --write-tree, exit 0).
  • migration_gate.json: both flags are false.
  • default_config.json and requirements.txt have no changes since v2.6.3. There is no new migration script.
  • python/tetra3 is not tracked.
  • No ADR number is used twice on main.
  • The i18n pass is complete.
  • version.txt reads 2.6.4 on main. This becomes true when this PR merges.
  • Until the cut, start the "Release NixOS image" workflow with --ref main only.

Open items for the cut

🤖 Generated with Claude Code

brickbots and others added 6 commits November 19, 2026 18:28
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…hort archive

The note in index.rst, quick_start.rst and user_guide.rst now lists 2.0.x,
2.1.x and 2.6.3, per the release playbook (add the previous release's
snapshot, drop the oldest).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Babel 2.16 on Python 3.9 finds the jinja2 extractor through pkg_resources,
which setuptools 81 removed. A fresh babel venv failed with "Unknown
extraction method 'jinja2'".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- New: Named Stars, the migration screen's three power and storage lines,
  and Back. Drafts are marked AI-TRANSLATED for review.
- Enter Local Time was in the code but marked obsolete in every catalog;
  it is active again with its existing translation.
- Exposure and Power + WiFi req are no longer used, so they are obsolete.

0 fuzzy and 0 untranslated in every catalog; each .mo is byte-identical
to a fresh pybabel compile.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The notes cover v2.6.3..main and link the catalog appendix
(release_notes/2.6.4-catalog.md). The plan follows the release playbook's
six gates; Gate 1 is green at b709c6f.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Testers get their own instructions. The test plan keeps its migration
gates.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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