This project is open source and welcomes contributions. Information on how to contribute can be found here.
All contributions need to follow the Code of Conduct, and the Conventions
these rules are in place to ensure that the project is consistent and easy to maintain.
Any contributions are welcome, whether it be a bug fix, a new feature, or a documentation update.
If you find any issues or have any suggestions, please open an issue.
To get started with contributing, you will need to set up the project on your local machine.
Cmake version 3.27 is used to build the
project, and Doxygen is used to
generate the documentation.
C++17 is used in this project, you're able to use compilers like clang, gcc and cl that support C++17.
To help with the development process, you can use an IDE
like CLion, Visual Studio
or Visual Studio Code. You're also able to run cmake
manually and use the compiler
of your choice.
Clone the repository to your local machine.
git clone https://github.com/BardoBard/Bardrix.git "Bardrix" && cd Bardrix
Now we need to build the project. You're also able to specify the compiler, architecture, debug/release, etc. but for a simple build, you can run the following command.
cmake -B build -S .
This will create a build directory with the necessary files to build the project.
Now we can compile the project.
cmake --build build
Depending on what operating system you're using, you'll be able to run the tests in Bardrix_Tests.
If you would like to contribute, please follow the steps below.
- Fork the repository.
- Clone the forked repository.
- Create a new branch.
- Make your changes.
- Update the documentation & add tests.
- Push the changes to your fork.
- Create a pull request.
- Make sure all the checks pass.
- Wait for the pull request to be reviewed.
Make sure to write good commit messages, and follow the conventions in the Conventions file.
If you're adding a new feature, make sure to add tests for it.
If you're fixing a bug, make sure to add a test that reproduces the bug.
Add documentation to the code you've written, and update the Bardrix_Reference and the
Release Notes if necessary.