davide
b292590cdc
docs/docs-as-code.md defines the workflow; docs/adr holds 31 ADRs (retroactive, reconstructed from code and changelog) with a template and index. docs/check-docs.sh validates ADR structure, index, cited code paths, relative links and CLAUDE.md/AGENTS.md sync.
984 B
984 B
0030. Single-source versioning with a mandatory changelog entry
- Status: Accepted
- Area: Distribution
- Recorded: 2026-11-03 (retroactive: reconstructed from code, comments and changelog)
Context
The App version, Android's display version and Android's versionCode must stay consistent, and versionCode must strictly increase or users cannot update in place.
Decision
<Version> in src/App/PalladiumWallet.App.csproj is the only source. update-version.sh updates it, mirrors ApplicationDisplayVersion in the Android head, increments ApplicationVersion and stubs a CHANGELOG.md entry. The changelog entry is filled in before or with the tag; commit and tag are manual.
Consequences
- The title bar, update checker (0023) and release builds read the same value.
- The changelog is the technical record of what shipped, not optional bookkeeping.
References
update-version.shCHANGELOG.mdsrc/App/PalladiumWallet.App.csproj