Simple description on how to contribute and interact with this repository.
-
Create feature branch
git checkout -b <feature-branch-name>
-
Make changes and commit them
git add . git commit -m "feat: add some changes" # Convential commits
-
Push local branch into git repository
git push origin -u <feature-branch-name>
-
In https://gitlab.moravia.com/devops/k8s-dashboard-guidepost/-/merge_requests create merge request for yor feature-branch to master.
-
Merge changes to master.
Commits message must follow Conventional commits.
Used verbs:
feat
- adding new features / functionalityfix
- fixing existing, but broken configurationrefactor
- refactoring existing configurationdocs
- changing README.md, CONTRIBUTING.md, TODO.mdci
- changing.gitlab-ci.yml
filestyle
- changes not fixing bugs or adding new functionality, but making chages to files and styling, e.g. idententation, docstring, etc.chore
- no changes, bumps, etc.
Commit messages should be in imperative.
Scopes are not strict, use what fits - for changing code of src/guidepost
,
use scope guidepost
, for nginx, nginx
, etc.
If changing more things at once, consider splitting this commit into more or use folder name as a scope.
When you are editing this repository, please setup pre-commit hooks.
We run our hooks on every commit to automatically point out issues in code
such as bad indentation, trailing whitespace, bad formatting inmarkdown files,
etc. List of all used hooks are in .pre-commit-config.yaml
.
-
install
pre-commit
-
once pre-cmomit is installed, install hooks
make pre-commit-install
-
all done, now githooks will run before every commit and check if your changes follow repository rules.