Thank you for your interest in contributing to Common Search!
Use these links to get started:
As a reminder, all contributors are expected to follow the Contributor Covenant.
Our operations have an early documentation.
Other docs about our general technical architecture are available too.
While testing our current UI Demo you should be able to find a few bugs (it's young!). Reporting them is a great first step to contributing!
First, locate the right repository for your issue:
- cosr-front for frontend issues (layout, search behaviour, browser issues, ...)
- cosr-results for issues related to the results themselves (relevance, title/description formatting, ...)
When in doubt, create the issue in cosr-results.
Before reporting the bug, make sure there isn't already an issue opened for that bug by looking at the open issues. When in doubt, create the issue anyway and a maintainer will help.
A great bug report should be precise, informative and courteous. Including direct links or screenshots of the issue is a big plus.
All our issues are tagged by difficulty, language and status. The label help wanted indicates that you are welcome to start investigating the issue immediately!
If you are not sure yet on how to fix an issue, don't worry! Just post a comment in the issue saying that you are interested and a maintainer will help you. We really want to make it as easy as we can for newcomers and you will be welcomed with open arms.
We also add a needs discussion label to issues for which we are not yet sure of the right solution. We would love having your opinion on them!
You should look at our INSTALL.md to learn how to setup this repository on you local machine. Spoiler: it's easy!
When contributing code, you will open a pull request so that the maintainers can check that everything looks good before merging your code. GitHub has a good documentation on [how pull requests work][pull-requests].
Before pushing your changes, you should try to run the tests locally with make test. Travis-CI will also automatically run them every time you push.
It's okay however to push failing tests in your branch if you need help from a maintainer!
Here are some more places to look for information:
- How to contribute: General info for developers, designers, testers, ...
- cosr-participation: Our repository dedicated to helping people get involved. You can create an issue there to give us feedback on your contribution experience!
Thanks again for joining the adventure!