Skip to content

Commit f511b19

Browse files
committed
Update README, CHANGELOG with gitflow
1 parent b42ef8a commit f511b19

File tree

3 files changed

+22
-2
lines changed

3 files changed

+22
-2
lines changed

.github/workflows/run_tests.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ name: Linting and tests
55

66
on:
77
push:
8-
branches: [ "main" ]
8+
branches: [ "main", "develop", "release/*" ]
99
pull_request:
1010

1111
permissions:

CHANGELOG.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Changelog
22

3+
## Unreleased
4+
5+
From this release forward, this project follows the `Git Flow` branching model. To reflect this, the default development branch have been renamed `develop`, and the `main` branch is now only for tagged releases.
6+
To read more about Git Flow, see (https://nvie.com/posts/a-successful-git-branching-model/). Also see [README](https://github.com/SallingGroup-AI-and-ML/venv-cli/blob/develop/README.md#git-flow) for branch naming conventions.
7+
8+
* Changed github test workflow to reflect new branch naming conventions.
9+
310
## [v1.1.0](https://github.com/SallingGroup-AI-and-ML/venv-cli/releases/tag/v1.1.0) (2023-08-02)
411

512
### New install script

README.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -162,13 +162,26 @@ As this is meant to be a lightweight tool providing simple, QoL improvements to
162162

163163
That said, pull requests are welcome. For bigger changes, please open an issue first to discuss what you would like to change.
164164

165-
To contribute, clone the repo, create a virtual environment (preferably using `venv-cli`) and install `dev-requirements.txt`. When you are done with your changes, run the test suite with
165+
To contribute, clone the repo and create a branch, create a virtual environment (preferably using `venv-cli`) and install `dev-requirements.txt`. When you are done with your changes, run the test suite with
166166
```console
167167
$ pytest .
168168
```
169+
then create a pull request for the `develop` branch.
169170

170171
Every subcommand has its own test file `tests/test_venv_<command>.py` Please make sure to add/update tests as appropriate.
171172

173+
### Git Flow
174+
This project follows the [Git Flow](https://nvie.com/posts/a-successful-git-branching-model/) branching model. The default development branch is accordingly named `develop`, and the branch `main` is reserved for tagged releases and hotfixes. Other branches should be named according to their purpose:
175+
```
176+
feature/<branch name>
177+
bugfix/<branch name>
178+
release/<branch name>
179+
hotfix/<branch name>
180+
support/<branch name>
181+
```
182+
183+
Releases are made by creating a branch `release/vX.X.X` from `develop`, where `X.X.X` represents the release version number, following [SemVer](https://semver.org/). This freezes the version number of **this release**, and no more features from `develop` should be merged into this release (only `bugfix/`). When the `release/` branch is ready for release, merge it into `main` and tag the commit with the release version, then merge the `release/` branch back into `develop` (resolving any merge conflicts) to get the bugfixes included there as well.
184+
172185
## License
173186

174187
[MIT](https://choosealicense.com/licenses/mit/)

0 commit comments

Comments
 (0)