# Release NEX-713 - Release Nextcloud Integration App 3.3.0

Project: Stream Nextcloud app "OpenProject Integration"
Status: in progress
URL: https://community.openproject.org/work_packages/NEX-713

## Details

| Attribute | Value |
| --- | --- |
| Date |  |
| Target versions |  Nextcloud Integration 3.3.0 |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work |  |
| Remaining work |  |

## Description

# **Prerequisites**

*   [x] All documentation changes are merged
*   [x] 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.
*   [x] In the `master` branch, bump the app version to the next version (e.g.: `X.(Y+1).0-alpha.1`).

<br>

*   [ ] Close version (<mention class="mention" data-id="83297" data-type="user" data-text="@Dominic Bräunlein">@Dominic Bräunlein</mention> , <mention class="mention" data-id="99509" data-type="user" data-text="@Yauheni Suhakou">@Yauheni Suhakou</mention> )
*   [ ] Close all work packages (<mention class="mention" data-id="83297" data-type="user" data-text="@Dominic Bräunlein">@Dominic Bräunlein</mention>, <mention class="mention" data-id="99509" data-type="user" data-text="@Yauheni Suhakou">@Yauheni Suhakou</mention> )
*   [ ] Create new version [here](https://community.openproject.org/projects/nextcloud-integration/settings/versions). &nbsp;(<mention class="mention" data-id="83297" data-type="user" data-text="@Dominic Bräunlein">@Dominic Bräunlein</mention>, <mention class="mention" data-id="99509" data-type="user" data-text="@Yauheni Suhakou">@Yauheni Suhakou</mention> )
*   [ ] Create new query [here](https://community.openproject.org/projects/nextcloud-integration/work_packages). (<mention class="mention" data-id="83297" data-type="user" data-text="@Dominic Bräunlein">@Dominic Bräunlein</mention>, <mention class="mention" data-id="99509" data-type="user" data-text="@Yauheni Suhakou">@Yauheni Suhakou</mention> )