This repository is the documentation for the open-source search engine API Meilisearch.
Hey, thank you so much for wanting to contribute! If you'd like to help improve this documentation, we'd love to have you!
Before opening an issue or PR, please look through our open issues to see if one already exists for your problem. If yes, please leave a comment letting us know that you're waiting for a fix or willing to work on it yourself. If not, please open a new issue describing the problem and informing us whether you want to work on it or not.
To contribute, clone this repository, commit your changes and open a pull request. Read more about working on this site locally.
Our only major requirement for PR contributions is that the author responds to communication requests within a reasonable timeframe.
Once you've opened a PR on this repo, one of our team members will stop by shortly to review it. If your PR is approved, nothing further is required from you. However, if in seven days you have not responded to a request for further changes or more information, we will consider the PR abandoned and close it.
If this happens to you and you think there has been some mistake, please let us know and we will try to rectify the situation.
- Node version >= v14 and <= v16
# Clone the repository
git clone [email protected]:meilisearch/documentation.git meilisearch-documentation
# Open the newly created directory
cd meilisearch-documentation
# Install dependencies
yarn install
# Run Meilisearch documentation on http://localhost:8080
yarn devA complete test can be done using the following command:
yarn testThe tests are triggered on build and on any pull request to main.
Making changes to the documentation without creating any dead links can be a tedious task. Before submitting any pull request, you can check the dead links.
yarn check-linksThe documentation follows styling rules. The following files will be checked: *.vue, *.js, and *.md.
You can check out and fix the styling errors.
yarn style:fixYou can test if the code is well-formatted without fixing it.
yarn styleScreenshots, images, GIFs, and video demonstrations should be placed in a relevant folder under .vuepress/public/ and then referenced from any markdown file a using relative link. For example, if you create the file .vuepress/public/my_cool_guide/my_cool_image.png, you would link to it from your document using .
The documentation is deployed as a static website. The main branch is automatically deployed at https://docs.meilisearch.com.
You can build the static website using the following command:
yarn build
# The website is now available in .vuepress/dist and you can serve it using any webserver.Feel free to contact us about any questions you may have:
- Join our Slack community.
- Open an issue!
Any suggestion or feedback is highly appreciated. Thank you for your support!