You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+41-8Lines changed: 41 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Contributing <!-- omit in TOC -->
2
2
3
-
First of all, thank you for contributing to MeiliSearch! The goal of this document is to provide everything you need to know in order to contribute to MeiliSearch and its different integrations.
3
+
First of all, thank you for contributing to Meilisearch! The goal of this document is to provide everything you need to know in order to contribute to Meilisearch and its different integrations.
4
4
5
5
-[Assumptions](#assumptions)
6
6
-[How to Contribute](#how-to-contribute)
@@ -11,8 +11,8 @@ First of all, thank you for contributing to MeiliSearch! The goal of this docume
11
11
## Assumptions
12
12
13
13
1.**You're familiar with [GitHub](https://github.com) and the [Pull Request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests) (PR) workflow.**
14
-
2.**You've read the MeiliSearch[documentation](https://docs.meilisearch.com) and the [README](/README.md).**
15
-
3.**You know about the [MeiliSearch community](https://docs.meilisearch.com/learn/what_is_meilisearch/contact.html). Please use this for help.**
14
+
2.**You've read the Meilisearch[documentation](https://docs.meilisearch.com) and the [README](/README.md).**
15
+
3.**You know about the [Meilisearch community](https://docs.meilisearch.com/learn/what_is_meilisearch/contact.html). Please use this for help.**
16
16
17
17
## How to Contribute
18
18
@@ -38,7 +38,7 @@ Each PR should pass the tests and the linter to be accepted.
38
38
39
39
```bash
40
40
# Tests with Jest
41
-
docker pull getmeili/meilisearch:latest # Fetch the latest version of MeiliSearch image from Docker Hub
41
+
docker pull getmeili/meilisearch:latest # Fetch the latest version of Meilisearch image from Docker Hub
42
42
docker run -p 7700:7700 getmeili/meilisearch:latest ./meilisearch --master-key=masterKey --no-analytics=true
43
43
# Integration tests
44
44
yarn test
@@ -115,7 +115,7 @@ Some notes on GitHub PRs:
115
115
116
116
## Release Process (for internal team only)
117
117
118
-
MeiliSearch tools follow the [Semantic Versioning Convention](https://semver.org/).
118
+
Meilisearch tools follow the [Semantic Versioning Convention](https://semver.org/).
119
119
120
120
### Automation to Rebase and Merge the PRs <!-- omit in TOC -->
121
121
@@ -143,12 +143,45 @@ GitHub Actions will be triggered and push the package to [npm](https://www.npmjs
143
143
144
144
Once the version is available on npm, please update the instant-meilisearch version used in the different Code-Sandboxes we provide:
If you don't have the access to do it, please request it internally.
151
151
152
+
#### Release a `beta` Version
153
+
154
+
Here are the steps to release a beta version of this package:
155
+
156
+
- Create a new branch originating the branch containing the "beta" changes. For example, if during the Meilisearch pre-release, create a branch originating `bump-meilisearch-v*.*.*`.<br>
157
+
`vX.X.X` is the next version of the package, NOT the version of Meilisearch!
158
+
159
+
```bash
160
+
git checkout bump-meilisearch-v*.*.*
161
+
git pull origin bump-meilisearch-v*.*.*
162
+
git checkout -b vX.X.X-beta.0
163
+
```
164
+
165
+
- Change the version in `package.json` by `vX.X.X-beta.0` and commit it to the `vX.X.X-beta.0` branch
166
+
167
+
- Go to the [GitHub interface for releasing](https://github.com/meilisearch/instant-meilisearch/releases): on this page, click on `Draft a new release`.
168
+
169
+
- Create a GitHub pre-release:
170
+
- Fill the description with the detailed changelogs
171
+
- Fill the title with `vX.X.X-beta.0`
172
+
- Fill the tag with `vX.X.X-beta.0`
173
+
- ⚠️ Select the `vX.X.X-beta.0` branch and NOT `main`
174
+
- ⚠️ Click on the "This is a pre-release" checkbox
175
+
- Click on "Publish release"
176
+
177
+
GitHub Actions will be triggered and push the beta version to [npm](https://www.npmjs.com/package/@meilisearch/instant-meilisearch).
178
+
179
+
💡 If you need to release a new beta for the same version (i.e. `vX.X.X-beta.1`):
180
+
- merge the change into `bump-meilisearch-v*.*.*`
181
+
- rebase the `vX.X.X-beta.0` branch
182
+
- change the version name in `package.json`
183
+
- creata a pre-release via the GitHub interface
184
+
152
185
<hr>
153
186
154
187
Thank you again for reading this through, we can not wait to begin to work with you if you made your way through this contributing guide ❤️
0 commit comments