1# Manage Releases
2
3## Release version naming
4- This plugin is provided as released DokuWiki installable ZIP packages with detailed release notes
5  via this repos [Release](https://github.com/woolfg/dokuwiki-plugin-gitbacked/releases) page.
6- The name of a release is identical to the `date` property in `plugin.info.txt` of that release.
7
8## Pre-Requisites
9- The release notes have to be maintained manually in [CHANGELOG.md](https://github.com/woolfg/dokuwiki-plugin-gitbacked/blob/master/CHANGELOG.md) - any details can be found in the comment section within this file.
10
11## Building a release
12- Releases are built by the `build_release.yml` GitHub Action workflow of this project.
13- A release build is triggered by applying a tag with name '**v**YYYY-MM-DD' to the corresponding most recent commit of this release.
14- The release workflow is not triggered, if:
15  - The release tag is not of format `v[0-9]+-[0-9]+-[0-9]+`
16- The release workflow is failing and no release will be created, if:
17  - The release version after the 'v'-prefix does not match the `date` property in file `plugin.info.txt`
18  - The `CHANGELOG.md` does not contain a line of format '# [YYYY-MM-DD]' matching the release version
19  - The `CHANGELOG.md` does not contain an appropriate compare link versus the previous release version at the end of the `CHANGELOG.md` file
20