Contributing Guide

Any contribution to this project means implicitly that you accept the code of conduct from this project.

Requirements

Git
Go >= 1.16

Optional:

GolangCI Lint >= 1.36
GNU Make >= 4.3 (build tool)
reflex >= 0.2 (filesystem watching)

Guidelines

Git commit messages: https://chris.beams.io/posts/git-commit/; additionally any commit must be scoped to the component where changes were made, which is prefixing the message with the component name, e.g. pkg/usersd: Do something.
Git branching model: https://guides.github.com/introduction/flow/.
Version number bumping: https://semver.org/.
Changelog format: http://keepachangelog.com/.
Go code guidelines: https://golang.org/doc/effective_go.html.

Instructions

Create a new branch with a short name that describes the changes that you intend to do. If you don't have permissions to create branches, fork the project and do the same in your forked copy.
Do any change you need to do and add the respective tests.
(Optional) Run make ci-race (or make ci if your platform doesn't support the Go's race conditions detector) in the project root folder to verify that everything is working.
Create a pull request to the master branch.