Last Updated: October 26th, 2023
Welcome to Bruno! This document provides guidelines for contributing to the project. By participating in this project, you agree to abide by its terms.
Contributions to Bruno can be made in various forms. Some of the ways you can contribute are:
- Submitting bug reports and feature requests
- Writing code for new features or bug fixes
- Improving documentation
- Fork and Clone: Fork the project on GitHub and then clone your fork locally.
- Create a Branch: Create a new branch in your local repository for each significant change.
- Commit Changes: Make your changes in your branch. Remember to keep your commits small and focused; they should explain why you made the change, not just what changed.
When contributing code, please keep the following in mind:
- Code Style: Maintain the chosen technology stack. Write code in a similar style as the existing code, including headers and comments.
- Testing: If present, add unit tests or update existing tests as necessary.
- Documentation: Update the documentation, the README, or other relevant documentation accordingly.
- Attribution: Each code file includes a list of authors. Consider adding your name to this list if you make modifications. While this is not mandatory, it helps acknowledge your contributions.
Before submitting a Pull Request (PR), ensure the following:
- You have merged the latest changes from the main branch into your branch.
- Your code compiles and runs without any errors.
- You have added or updated tests as necessary.
- You have updated the documentation if required.
- The PR title and description clearly describe the changes you are proposing.
Once you submit a PR, the project maintainers will review your changes. The review process might include suggestions for improvements or requests for changes.
When reporting issues, please provide:
- A clear and descriptive title.
- A detailed description of the issue.
- Steps to reproduce the issue.
- Any relevant logs or error messages.
If you have questions or suggestions about the contribution process, feel free to reach out to the maintainers or open an issue for discussion.