[joshschmelzle]

Why

A changelog edit on main is what publishes a package today, so fix pull requests were taking a version with them. A fix should land with no version. The release pull request is the one that sets it.

What changed

• Added the procedure for a fix, a dev build, the next release version, and a release.
• Pointed the release, contributing, and debchange pages at that procedure.
• Removed the fix-branch version bump.
• After review, separated live steps from planned CI, limited the page to first-party changelogs, and required a version that is not already on wlanpi/dev or wlanpi/main.

Scope

Contributor and maintainer docs in this repo. No CI change, no package version bump, and no edit to REPOS.md. Draft pull request 48 is untouched. The dev stamp and the direct upload to wlanpi/main are written as not live yet.

Tradeoffs

The page states both the upload that happens today and the planned upload. Writing only the future upload would tell a maintainer to skip a promote the workflow still performs.

Blast Radius

Docs only. A fix that follows the page does not publish until a release pull request. That gap is intended until the stamp CI lands.

Verification

• Relative links in the changed pages resolve to a file and a heading.
• dpkg 1.22.6 sorts 2.4.12-1 below 2.4.13~dev20261024.1842.1+gabcdef1, below 2.4.13~rc1, below 2.4.13. It also sorts 2.5.0 above 2.4.14~dev20261024.1842.1+gabcdef1, and 2.5.0~rc1 below 2.5.0~rc2.
• 7.3.0-rc5-2712-wlanpi-2026090114 sorts above 7.3.0-2712-wlanpi-2026102509 and below 7.3.1-2712-wlanpi-2026102414.
• The release commands are dch -v 2.4.13, then dch -a once per subject, then dch -r "".
• The example log starts at tag v2.4.12, which exists. Tag v2.4.13 does not.
• The pi-gen release page returns HTTP 200. Changelog tops on 2026-10-25 are still core 2.4.12-1, webui 1.21.18-1, fpms 1.4.25-1, profiler 2.1.8-1, and mcp 0.7.0-1.

  

---

Note

Low Risk
Documentation-only changes to contributor and maintainer workflows; no CI or application code is modified.

^{Reviewed by Cursor Bugbot for commit 8b762cd. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Approved. Cursor Bugbot completed successfully and reported no findings that need human review, and no approval policy requires a human reviewer.

  

_{Sent by Cursor Approval Agent: Pull Request Router and Approver}