Skip to content

Release and packaging guide

The release section covers steps that move Ferrex from reviewed development work to packaged artifacts and stable channels. It does not add deployment, hosting, DNS, or secret-dependent automation.

PageUse it for
Flathub submission guidePreparing the Flatpak manifest submission, creating the Flathub app branch, and post-merge maintenance expectations.
Crate README inventoryPackage-facing crate README files that remain canonical for package consumers.
Project policiesSecurity, contribution, trademark, and conduct policies used during release review.

Source material still owned by the repository

Section titled “Source material still owned by the repository”
  • README.md lists core packaging commands and platform support.
  • packaging.toml, dist-workspace.toml, flatpak/, and docker/ contain target-specific packaging configuration.
  • CHANGELOG.md tracks release highlights and roadmap notes.

Promotion from dev to main remains a separate human-reviewed release decision.