|
| 1 | +# Contributing |
| 2 | + |
| 3 | +Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great. |
| 4 | + |
| 5 | +Contributions to this project are [released](https://help.github.com/articles/github-terms-of-service/#6-contributions-under-repository-license) to the public under the [project's open source license](LICENSE.md). |
| 6 | + |
| 7 | +Please note that this project is released with a [Contributor Code of Conduct][code-of-conduct]. By participating in this project you agree to abide by its terms. |
| 8 | + |
| 9 | +## Reporting Bugs |
| 10 | + |
| 11 | +The best way to report a bug is to open an issue on GitHub. Please include as much information as possible, including: |
| 12 | + |
| 13 | +- A clear description of the problem |
| 14 | +- Steps to reproduce the problem |
| 15 | +- The expected behavior |
| 16 | +- The actual behavior |
| 17 | + |
| 18 | +This will help us understand the issue and fix it more quickly. |
| 19 | + |
| 20 | +## Suggesting Enhancements |
| 21 | + |
| 22 | +If you have an idea for a new feature or enhancement, please open an issue on GitHub. |
| 23 | + |
| 24 | +## Submitting Changes |
| 25 | + |
| 26 | +1. [Fork][fork] and clone the repository |
| 27 | +2. Create a new branch for your changes |
| 28 | +3. Make your changes |
| 29 | +4. Write tests for your changes (if applicable) |
| 30 | +5. Run the tests to make sure everything is working |
| 31 | + |
| 32 | +### Required Tools |
| 33 | + |
| 34 | +- [Rust](https://www.rust-lang.org/tools/install) |
| 35 | +- [Cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html) |
| 36 | +- [CodeQL](https://codeql.github.com/docs/codeql-cli/getting-started/) |
| 37 | + - `gh-codeql` is a great tool to help you with CodeQL CLI. |
| 38 | + |
| 39 | +### Running Tests |
| 40 | + |
| 41 | +To run the tests, use the following command: |
| 42 | + |
| 43 | +```bash |
| 44 | +cargo test |
| 45 | +``` |
| 46 | + |
| 47 | +### Running Linter |
| 48 | + |
| 49 | +To run the linter, use the following command: |
| 50 | + |
| 51 | +```bash |
| 52 | +cargo clippy |
| 53 | +``` |
| 54 | + |
| 55 | +## Resources |
| 56 | + |
| 57 | +- [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/) |
| 58 | +- [Using Pull Requests](https://help.github.com/articles/about-pull-requests/) |
| 59 | +- [GitHub Help](https://help.github.com) |
| 60 | + |
| 61 | +[fork]: https://github.com/advanced-security/codeql-extractor-action/fork |
| 62 | +[pr]: https://github.com/advanced-security/codeql-extractor-action/compare |
| 63 | +[code-of-conduct]: https://github.com/advanced-security/codeql-extractor-action |
| 64 | + |
0 commit comments