I am delighted that you are interested in contributing to Hephaistos! This document provides guidelines for contributions to the project. Whether you're submitting a bug report, proposing a new feature, or submitting a code change, your contribution is highly valued and appreciated.
- Fork the repository: start by forking the repository on GitHub. This will create a copy of the repository in your own GitHub account.
- Clone the repository: clone the repository to your local machine
git clone https://github.com/[YourUsername]/Hephaistos.git
cd Hephaistos
- Create a branch: create a new branch to work on. It is recommended to name your branch after the issue you are working on.
git branch feature/my-new-feature
git checkout feature/my-new-feature
or
git branch bugfix/my-bug-fix
git checkout bugfix/my-bug-fix
- Make changes: Implement your feature or fix and commit your changes with clear and concise commit messages. Be sure to follow the Code Style guidelines.
- Test Your Changes: Ensure your changes do not break existing functionality and that they meet the project's coding standards. (See Testing and Code Style)
- Pull Request: Push your branch to your fork and open a pull request against the main Hephaistos repository. Provide a clear description of your changes and their purpose.
Hephaistos uses the (KronOS) build system, which includes a testing framework. Tests are located in the tests
directory. You can add new tests to the existing test files or create new test files. Tests are automatically run when building the project.
Hephaistos follows the Linux Kernel Coding Style.
If you find a bug or have a suggestion for a new feature, please use the GitHub issue tracker. Before creating a new issue, check if it has already been reported or fixed in the main branch.
Code Style: Follow the established code style of the project.
Documentation: Add comments and documentation to your code as needed.
Testing: Add tests for new features and ensure that your changes do not break existing tests.
I aim to build a welcoming and inclusive community. Please adhere to our Code of Conduct in all your interactions with the project.
By contributing to Hephaistos, you agree that your contributions will be licensed under its MIT License.
If you have any questions or need help, feel free to reach out to me or use the community channels.
Thank you for contributing to Hephaistos, and I look forward to seeing your contributions!