Update release guide with lessons from 9.1.0-RC1#11621
Conversation
- Add version string format section: lowercase rc + hyphen required by Configurator firmware flasher regex (uppercase RC causes firmware to be invisible in flasher after upload) - Fix rename script: use hyphen separator in output filename to match the required inav_<version>-rc<n>_<TARGET>.hex pattern - Replace directory-flattening find command with platform-organized mkdir/mv; flattening caused a Windows .exe inside macOS DMG in 9.0.0 - Add PR branch verification step in changelog section: gh pr list shows PRs by date regardless of target branch, so PRs on maintenance-10.x can appear falsely - Update gh release create examples: add --prerelease for RC releases, use --target <sha> for atomic tagging at a specific commit - Add post-publish verification: confirm firmware appears in Configurator Firmware Flasher before publishing the Configurator release
Qodo reviews are paused for this user.Troubleshooting steps vary by plan Learn more → On a Teams plan? Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center? |
Branch Targeting SuggestionYou've targeted the
If This is an automated suggestion to help route contributions to the appropriate branch. |
|
Test firmware build ready — commit Download firmware for PR #11621 238 targets built. Find your board's
|
Summary
Updates
docs/development/release-create.mdwith lessons learned during the 9.1.0-RC1 release process.rcwith a hyphen (e.g.,9.1.0-rc1). The Configurator firmware flasher uses a case-sensitive regex; uppercaseRCor underscore separators cause the target board name to be misread, making the firmware invisible in the flasher even after a successful upload._rc2_(underscore) but the required format is-rc2_(hyphen). This would have produced filenames that the Configurator cannot parse.find . -mindepth 2 -type f -exec mv -t . {} +to flatten all files into one directory. This exact pattern caused a Windows.exeto be packaged inside a macOS DMG in the 9.0.0 release. Replaced with explicit per-platformmkdir/mv.gh pr listreturns PRs by merge date regardless of target branch, so PRs merged tomaintenance-10.xappear in results even if they are not part of the current release. Added commands to verify each PR is actually on the release branch.gh release createexamples: Added--prereleasefor RC releases and--target <commit-sha>to tag a specific commit atomically without needing local repo access.Test plan
inav_9.1.0-rc1_TARGET.hexformatRCnaming remain