Most of our contributing guidelines are taken from the Zephyr project, so please refer to the Zephyr contributing guidelines for more information and help.
Code formatting is automated and checked in CI using the pre-commit
tool, so it behooves you to install and
configure
it now. Install pre-commit
using pip3 install pre-commit
or it might already be installed in
the conda environment.
Configure pre-commit
using the config in the repo:
cd "$REPO_DIR"/orb/public
pre-commit install -c utils/format/pre-commit-config.yaml --hook-type commit-msg
Manually:
cd "$REPO_DIR"/orb/public && pre-commit run --all-files --config utils/format/pre-commit-config.yaml
Using Docker:
cd "$REPO_DIR"/orb/public/utils/docker
make format
Create a feature branch by prefixing with your name name/
.
gitlint
is used to enforce commit message style. Commit message guidelines
are directly from the Zephyr
project (Zephyr guidelines).
Install gitlint
using pip3 install gitlint
, or it might already be installed in
the conda environment.