👍🎉 First off, thanks for taking the time to contribute! 🎉👍
The easiest way to start coding is to jump straight into Gitpod. You can either click the button
below or prefix any mp-units
URL (main branch, other branches, issues, PRs, ...) in your web browser with gitpod.io/#
(i.e. https://gitpod.io/#https://github.com/mpusz/units).
The above environment provides you with:
- all supported compilers for Linux development (
g++-10
,g++-11
,g++12
,clang-13
,clang-14
, andclang-15
) and the latest version of build tools likecmake
andconan
- all Conan dependencies preinstalled on the machine
- all documentation generation tools ready to use
- completed prebuilds for all targets (Debug and Release builds for each compiler as well as a documentation)
- VSCode preconfigured to benefit from all the above
Alternatively, please refer to our official docs for download, build, and install instructions if you want to setup a development environment on your local machine.
There is a formatting standard enforced with the pre-commit
script. Before committing your changes please do the following:
pip3 install -U pre-commit
pre-commit run --all-files
This will run clang-format
for code formatting with the .clang-format
file provided in the repo, cmake-format
to format the CMake files, and some other check as well.
The script will run on all the files in the repo and will apply the changes in-place when needed.
After the script is done please make sure to stage all those changes to git commit.
Here are the main rules for naming things in this repo:
- types, functions, variables naming in a
standard_case
- template parameters in a
PascalCase
- C++20 concepts names for now in a
PascalCase
but we plan to change it (see mpusz#93 for more details)
Before submission, please remember to check if the code compiles fine on the supported compilers. The CI will check it anyway but it is good to check at least some of the configurations before pushing changes. Especially older compilers can be tricky as those do not support all the C++20 features well enough. The official list of supported compilers can be always found on our Usage page.
If you are looking for a good issue to start with, please check the following:
- good first issue - issues that should be pretty simple to implement.
- help wanted - issues that typically are a bit more involved than beginner issues.
- high priority - things to fix ASAP but often of higher complexity.