Skip to content

Commit cac6e23

Browse files
committed
[INTERNAL] Guidelines: Document up-porting to main
1 parent 8995b9b commit cac6e23

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

docs/Guidelines.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,11 +50,11 @@ Fixes: #45
5050
```
5151

5252
## Work on Release Branches
53-
Major releases are typically prepared on dedicated branches like `next`.
53+
Currently, the `v4` branch is the latest stable release, while the next major release (`v5`) is being developed on the `main` branch.
5454

55-
There are some things to be aware of when working on these branches.
55+
There are some things to be aware of when working across these branches.
5656

57-
### Implementing Changes in Multiple Code Lines
58-
While working on a new major release (e.g. `5.0.0`), any fixes or new features implemented on the **current** (main) code line (e.g. 4.x) should be cherry-picked as `[INTERNAL]` to the dedicated (pre-)release branch (typically `next`). This is to prevent changes declared as `[FEATURE]` or `[FIX]` from appearing in the changelog twice, which can be confusing since the new major version has not yet been released and should naturally contain any fixes or features released in any of the preceding releases. Listing them twice might confuse users. Note that our changelog is generated based on all tags of the repository, independent of the currently checked out branch (also see [git-chglog/issues/123](https://github.com/git-chglog/git-chglog/issues/123)).
57+
### Implementing Fixes Across `v4` and `main` Branches
58+
During the development period until the first `v5` release, fixes should be implemented on the **`v4` branch first**, and then up-ported to the **`main` branch**. This ensures that the stable release receives fixes promptly while maintaining consistency across both code lines.
5959

60-
However, once a new major release becomes **current** (i.e. "main", not a pre-release), any changes applied to multiple code lines should be cherry picked with the original prefix, so that they appear for multiple versions in the changelog.
60+
When up-porting fixes from `v4` to `main`, note that the commit message guidelines differ between branches. The `v4` branch uses the OpenUI5-style commit message format (as documented above), while the `main` branch uses conventional commits. Please refer to the [Guidelines.md file on the main branch](https://github.com/UI5/cli/blob/main/docs/Guidelines.md) for the appropriate commit message format when working there.

0 commit comments

Comments
 (0)