docs: add docs-as-code process and one ADR per feature
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.
This commit is contained in:
1 parent
ce8d777c63
commit
b292590cdc
36 files changed
+987
No files matched your search
@@ -0,0 +1,24 @@
|
||||
# 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.sh`
|
||||
- `CHANGELOG.md`
|
||||
- `src/App/PalladiumWallet.App.csproj`
|
||||
Reference in new issue
Block a user