slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

;doc: RELEASING: updates

Browse Source
This commit is contained in:
Simon Michael 2021-09-25 12:17:27 -10:00
parent 277cb4f500
commit 342ccdfae1
1 changed files with 15 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
RELEASING.md
View File

@ -5,24 +5,25 @@
</div> </div>
Guidance for release managers and maintainers. Guidance for release managers and maintainers.
Some of this might move elsewhere later.
## Terminology Some terminology used on this page:
- **OLD** - previous release version, eg `1.22` or `1.22.1` | | |
- **NEW** - new release version, eg `1.22.2` or `1.23` |-------------------------|---------------------------------------------------------------------------------------|
- **MAJORVER** - just the major version part, eg `1.22` or `1.23` | *OLD* | previous release version, eg `1.22` or `1.22.1` |
- **master** / **master branch** - `master` branch in the main hledger repo | *NEW* | new release version, eg `1.22.2` or `1.23` |
- **release** / **release branch** - a release branch in the main hledger repo, named MAJORVER-branch, eg `1.22-branch` | *MAJORVER* | just the major version part, eg `1.22` or `1.23` |
- **site** / **site repo** - master branch in the hledger_website repo, usually cloned under the main repo as `site` | *master (branch)* | `master` branch in the `hledger` repo, ie the main line of development |
| *release&nbsp;(branch)* | a release branch in the `hledger` repo, eg `1.22-branch` |
| *site* | `master` branch in the `hledger_website` repo. Usually checked out as `hledger/site`. |
| | |
## Commits ## When committing / reviewing commits
**When committing/reviewing:** Follow/encourage [commit conventions](CONTRIBUTING.html#commit-messages). Recap:
- commit messages must begin with one or more colon-terminated words
Follow our [commit conventions](CONTRIBUTING.html#commit-messages): - user-visible changes must begin with a `feat:`/`imp:`/`fix:` prefix, and will appear in release notes
- in the summary, use a `feat:`/`imp:`/`fix:` prefix (required for user-visible changes), - other changes can begin with a topic prefix (`bal:`/`areg:`/`test:`/`doc:`/`lib:`/...)
and/or topic prefixes (`bal:`/`areg:`/`test:`/`doc:`/`lib:`/...)
- add a leading `;` to skip wasteful CI builds - add a leading `;` to skip wasteful CI builds
- add a `!` to indicate breaking/incompatible changes - add a `!` to indicate breaking/incompatible changes
- mention any relevant #issue numbers, usually parenthesised at the end - mention any relevant #issue numbers, usually parenthesised at the end