|
| 1 | +# Contributing to WebWand |
| 2 | + |
| 3 | +Thank you for your interest in contributing to WebWand! WebWand is a tool that simplifies web interactions through the innovative use of multi-modal Large Language Models, offering users a more intuitive and efficient online experience. We welcome contributions from the community to help make WebWand even better. |
| 4 | + |
| 5 | +## How to Contribute |
| 6 | + |
| 7 | +There are many ways to contribute to WebWand, from writing code to improving documentation, reporting bugs, and suggesting enhancements. Here's how you can get started: |
| 8 | + |
| 9 | +### Spread the Word |
| 10 | +If you love WebWand, you can make a big difference by telling others about it. Write a blog post, talk about it on social media, or share your experience with friends and colleagues. Every bit helps in growing our community and bringing new contributors on board. |
| 11 | + |
| 12 | +### Reporting Bugs |
| 13 | + |
| 14 | +Before reporting a new bug, please ensure that the issue has not already been reported. You can do this by searching through the existing issues in our GitHub repository. |
| 15 | + |
| 16 | +If you encounter a bug while using WebWand and it has not been reported yet, please report it by creating a new issue. Be sure to include: |
| 17 | + |
| 18 | +- A clear and descriptive title |
| 19 | +- A detailed description of the bug, including steps to reproduce it |
| 20 | +- Any relevant screenshots or error messages |
| 21 | +- Your WebWand version and browser details |
| 22 | + |
| 23 | +### Suggesting Enhancements |
| 24 | + |
| 25 | +We're always looking for ways to improve WebWand. If you have an idea for a new feature or an enhancement to an existing one, please submit it as an issue, using a clear and concise title and description. Explain why this enhancement would be useful, and if possible, include examples of how it could be implemented. |
| 26 | + |
| 27 | +### Contributing Code |
| 28 | + |
| 29 | +Confirm alignment on the proposed work. For small fixes or minor enhancements, make sure there is an open and accepted issue. For larger contributions, a design or plan should have been reviewed and agreed upon by the maintainers. |
| 30 | + |
| 31 | +Before submitting your first code contribution, please make sure to: |
| 32 | + |
| 33 | +1. Clone the repository. |
| 34 | +2. Follow the setup instructions in the README.md to get your development environment running. |
| 35 | +4. Make your changes in a new git branch and test your changes locally. |
| 36 | +5. Commit your changes using a clear and descriptive commit message. |
| 37 | +6. Push your branch to GitHub and open a pull request against the `main` branch. In your pull request, include any relevant issue numbers and a description of the changes you've made. |
| 38 | + |
| 39 | +### Pull Request Guidelines |
| 40 | + |
| 41 | +- Ensure that your code follows the project's coding conventions and is properly documented. |
| 42 | +- Include screenshots or animated GIFs in your pull request whenever possible, especially for UI-related changes. |
| 43 | +- Follow the [Pull Request Template](https://github.com/normal-computing/web-wand/PULL_REQUEST_TEMPLATE.md) provided in the repository for the description of your pull request. |
| 44 | + |
| 45 | +### Code Review Process |
| 46 | + |
| 47 | +After you submit a pull request, the project maintainers will review your proposed changes. This process helps to ensure the quality and consistency of the WebWand codebase. The review may require some back-and-forth communication, so please be patient. We appreciate your contributions and will do our best to provide feedback and guidance as quickly as possible. |
| 48 | + |
| 49 | +## Community and Conduct |
| 50 | + |
| 51 | +We are committed to providing a welcoming and inspiring community for all. We encourage all contributors to foster an open and welcoming environment, and to be respectful of differing viewpoints and experiences. |
| 52 | + |
| 53 | +## Acknowledgements |
| 54 | + |
| 55 | +Your contributions help make WebWand a better tool for everyone. We look forward to your ideas, feedback, and contributions. Thank you for being part of the WebWand community! Happy contributing! |
0 commit comments