# **Prerequisites**

* [ ] All documentation changes are merged
* [ ] Translations are done

# Release preparation

### a. Major/Minor Release

* [x] Create a release branch from the master with the format `release/<major>.<minor>` (e.g. `release/2.1`).

On the release branch:

* [x] In case any new feature was added, update the feature description in:
* `README.md`

* `appinfo/info.xml`

* [x] Update the version in:
* `appinfo/info.xml`

* `package.json`

* [x] Add the new release branch in `.tx/backport` to allow transifex commits.
* [x] Update `CHANGELOG.md` with the changes and the version to be released.
* [x] Update the new release branch in the [nightly CI](https://community.openproject.org/.github/workflows/nighlty-ci-release-branch.yml).

### b. Patch Release

On the current release branch:

* [ ] Update the patch version in:
* [ ] `appinfo/info.xml`
* [ ] `package.json`
* [ ] Update `CHANGELOG.md` with the changes and the version to be released.

<br>

# Publish Release

> The tag MUST follow the following format:
>
> * For release: `vX.Y.Z` (e.g. `v2.1.1`)
>
> * For test release: `vX.Y.Z-yyyymmdd-nightly` (e.g. `v2.1.1-20220928-nightly`)
>

* [x] Tag a commit from the release branch.

```bash
git tag vX.Y.Z -m "vX.Y.Z"

# E.g.:
# git tag v2.1.1-20220928-nightly -m "v2.1.1-20220928-nightly"
```

> _**NOTE:**_ Every tag should be created with a unique commit, or the publish will fail.

<br>

* [x] Push the tag to the `auto-release` branch.

```bash
git push origin release/<major>.<minor>:auto-release vX.Y.Z

# E.g.:
# git push origin release/2.1:auto-release v2.1.1-20220928-nightly
```

* [x] Approve the deployment in GitHub actions.
* [x] Check the release on Nextcloud [app store](https://apps.nextcloud.com/apps/integration_openproject/releases).

<br>

# After Release

* [x] Add the release notes to the newly created [GitHub release](https://github.com/nextcloud/integration_openproject/releases).
* [x] Merge the necessary commits from the release branch into the `master` branch.
* Begin of the insertion[x]End of the insertion Begin of the deletion [ ]End of the deletion In the `master` branch, bump the app version to the next version (e.g.: `X.(Y+1).0-alpha.1`).

<br>

* [ ] Close version (@Dominic)
* [ ] Close all work packages (@Dominic)
* [ ] Create new version [here](https://community.openproject.org/projects/nextcloud-integration/settings/versions). &nbsp;(@Dominic)
* [ ] Create new query [here](https://community.openproject.org/projects/nextcloud-integration/work_packages). (@Dominic)