Skip to content

Commit d78de1c

Browse files
authored
feat: added contribution guide and pull request template (#115)
* feat: added contribution guides * fix: add readme link to contributing guide * fix: update contributing guide
1 parent 8568e17 commit d78de1c

File tree

3 files changed

+98
-0
lines changed

3 files changed

+98
-0
lines changed

CONTRIBUTING.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
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!

PULL_REQUEST_TEMPLATE.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
## Description
2+
3+
Please include a summary of the changes you have made. Describe any new features, bug fixes, or improvements you have introduced. If your changes address an open issue, please include a reference to it (e.g., `Fixes #123`).
4+
5+
## Type of Change
6+
7+
Please delete options that are not relevant.
8+
9+
- [ ] New feature (non-breaking change which adds functionality)
10+
- [ ] Bug fix (non-breaking change which fixes an issue)
11+
- [ ] Documentation update
12+
- [ ] Code style update (formatting, renaming)
13+
- [ ] Refactoring (no functional changes, no API changes)
14+
- [ ] Build-related changes
15+
- [ ] Other (please describe):
16+
17+
## How Has This Been Tested?
18+
19+
Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce the testing. Please also list any relevant details for your test configuration.
20+
21+
- [ ] Test A
22+
- [ ] Test B
23+
24+
## Checklist:
25+
26+
Before submitting your pull request, please review the following checklist:
27+
28+
- [ ] I have proved my fix is effective or that my feature works.
29+
- [ ] I have performed a self-review of my own code.
30+
- [ ] I have commented on my code, particularly in hard-to-understand areas.
31+
- [ ] My changes generate no new warnings.
32+
33+
## Screenshots (if applicable)
34+
35+
If your changes are visual and it helps to illustrate them, please include screenshots or GIFs here.
36+
37+
## Additional Context
38+
39+
Provide any additional information about your pull request here.

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,10 @@ When loading the extension, you will need to load the `dist` folder created by t
5959
- Add support for sharing workflows & knowledge with others
6060
- Create wikipedia-like knowledge base where users can work together to create knowledge that can improve the WebWand's performance
6161

62+
## Contributing
63+
64+
Interested in contributing to WebWand? We'd love your help! Check out our [Contribution Guide](CONTRIBUTING.md) for guidelines on how to contribute, report bugs, suggest enhancements, and more.
65+
6266
## Credits
6367

6468
- WebWand's image annotation method was inspired by Microsoft's [UFO paper](https://arxiv.org/abs/2402.07939).

0 commit comments

Comments
 (0)