Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
96 lines (64 loc) · 2.48 KB

CONTRIBUTING.md

File metadata and controls

96 lines (64 loc) · 2.48 KB

Contributing to BotWave

Thank you for your interest in contributing to BotWave!
Contributions of all kinds are welcome, whether it’s code, documentation, bug reports, or suggestions.

Please take a moment to read this guide before contributing.

Ways to Contribute

You can contribute by:

  • Reporting bugs
  • Suggesting new features or improvements
  • Improving documentation
  • Submitting pull requests
  • Reviewing existing pull requests

Reporting Bugs & Issues

If you encounter a bug or unexpected behavior, please open an issue in the
/issues section.

When reporting an issue, try to include:

  • A clear and descriptive title
  • Steps to reproduce the issue
  • Expected behavior vs actual behavior
  • Relevant logs, screenshots, or error messages
  • Your environment (OS, version, setup, etc.)

Security vulnerabilities should NOT be reported via issues.
Please refer to the SECURITY.md file for responsible disclosure instructions.

Feature Requests

Feature requests are welcome!
Before opening a new issue, please check if a similar request already exists.

When suggesting a feature:

  • Explain the problem it solves
  • Describe the proposed solution
  • Mention any alternatives you’ve considered

Pull Requests

We’re happy to review pull requests!

Before submitting a PR:

  • Fork the repository and create a new branch
  • Keep changes focused and relevant
  • Follow the existing code style and structure
  • Test your changes where applicable
  • Update documentation if needed

When opening a pull request:

  • Clearly describe what your PR does
  • Reference related issues if applicable
  • Be open to feedback and requested changes

Code Style & Guidelines

  • Keep code clean, readable, and well-organized (at least try to)
  • Avoid unnecessary dependencies
  • Comment complex or non-obvious logic

Commit Messages

Please use clear and descriptive commit messages.
For the moment, we don't have a specific commit template, such as conventional commits, however, we'd like having:

  • No garbage commits (e.g, adsfds)
  • Clear mention of the component / feature affected (e.g, server: added xy or added xy in server.py)

Community & Conduct

Be respectful and constructive in discussions.
Harassment, hate speech, or hostile behavior will not be tolerated.

Questions

If you’re unsure about anything, feel free to open an issue and ask.

Thanks for helping make BotWave better <3