MiniSearch are welcome :) Just follow the guidelines below.
Bugs and feature requests
If you have an idea for a feature, or spotted a bug, please open an issue on GitHub.
Check if your issue was already reported. In that case, better to comment on the existing issue rather than open a duplicate one.
When reporting a bug, whenever possible, provide some example code to reproduce the bug: that will make the process of fixing it much faster.
Remember this is an open-source project. Your feature requests will be discussed and taken into consideration, but please do not take it personally if the feature does not get implemented. This project uses a permissive license, so pull requests are welcome and forks are permitted.
Always be respectful of others when discussing issues. The project maintainer has the right and responsibility to remove or close discussions where the tone or language is derogatory, harassing, or offensive toward others. Keep the Code of Conduct in mind.
Thinking about sending a pull request? That is great :) Here is how you can setup your development environment:
Clone the repository
Install the development dependencies with
Run the tests with
yarn test. You can also automatically trigger a run of relevant tests for the code that you change by running
If you are working on optimising the performance, you can run the performance benchmarks with
If you are improving the documentation, you can build the docs with
In order to understand implementation details and design goals, read the design document.
Also, please follow these guidelines:
Add tests for your code. This ensures that your feature won't be broken by further code changes. If you are not sure how to test, feel free to send the pull request and ask for advices in the comment.
Don't change the version number. That will be done by the mainteiner upon releasing a new version.
Make sure that the full test suite passes before sending the pull request.