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
+15-3Lines changed: 15 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ First of all, thank you for contributing to Meilisearch! The goal of this docume
22
22
4. Review the [Development Workflow](#development-workflow) section that describes the steps to maintain the repository.
23
23
5. Make the changes on your branch.
24
24
6.[Submit the branch as a PR](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork) pointing to the `main` branch of the main strapi-plugin-meilisearch repository. A maintainer should comment and/or review your Pull Request within a few days. Although depending on the circumstances, it may take longer.<br>
25
-
We do not enforce a naming convention for the PRs, but **please use something descriptive of your changes**, having in mind that the title of your PR will be automatically added to the next [release changelog](https://github.com/meilisearch/strapi-plugin-meilisearch/releases/).
25
+
We do not enforce a naming convention for the PRs, but **please use something descriptive of your changes**, having in mind that the title of your PR will be automatically added to the next [release changelog](https://github.com/meilisearch/strapi-plugin-meilisearch/releases/).
26
26
27
27
## Development Workflow
28
28
@@ -31,6 +31,7 @@ First of all, thank you for contributing to Meilisearch! The goal of this docume
31
31
You can set up your local environment natively or using `docker`, check out the [`docker-compose.yml`](/docker-compose.yml).
32
32
33
33
Example of running all the checks with docker:
34
+
34
35
```bash
35
36
docker-compose run --rm package bash -c "yarn install && yarn test && yarn playground:build && yarn style"
36
37
```
@@ -56,21 +57,31 @@ yarn test
56
57
yarn style
57
58
# Linter with fixing
58
59
yarn style:fix
60
+
# E2E tests
61
+
yarn dlx cypress open
59
62
```
60
63
61
64
### Run Playground
62
65
63
66
To test directly your changes on the plugin in Strapi, you can run the Strapi playground:
64
67
65
68
```bash
69
+
# Root of repository
70
+
yarn watch:link # Build the plugin and release it with yalc
yarn playground:dev # Start the development server
69
79
```
70
80
71
81
This command will install required dependencies and launch the app in development mode. You should be able to reach it on the [port 8000 of your localhost](http://localhost:8000/admin/).
72
82
73
83
Once on the admin panel, you are required to log-in. Here are the credentials:
@@ -84,6 +95,7 @@ We do not enforce any branch naming style, but please use something descriptive
84
95
### Git Commits <!-- omit in toc -->
85
96
86
97
As minimal requirements, your commit message should:
98
+
87
99
- be capitalized
88
100
- not finish by a dot or any other punctuation character (!,?)
89
101
- start with a verb so that we can read your commit message this way: "This commit will ...", where "..." is the commit message.
@@ -134,7 +146,7 @@ GitHub Actions will be triggered and push the package to [npm](https://www.npmjs
134
146
Here are the steps to release a beta version of this package:
135
147
136
148
- 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>
137
-
`vX.X.X` is the next version of the package, NOT the version of Meilisearch!
149
+
`vX.X.X` is the next version of the package, NOT the version of Meilisearch!
138
150
139
151
```bash
140
152
git checkout bump-meilisearch-v*.*.*
@@ -144,7 +156,6 @@ git checkout -b vX.X.X-beta.0
144
156
145
157
- Change the version in [`package.json`](/package.json) and commit it to the `beta` branch.
146
158
147
-
148
159
- Go to the [GitHub interface for releasing](https://github.com/meilisearch/strapi-plugin-meilisearch/releases): on this page, click on `Draft a new release`.
149
160
150
161
- Create a GitHub pre-release:
@@ -158,6 +169,7 @@ git checkout -b vX.X.X-beta.0
158
169
GitHub Actions will be triggered and push the beta version to [npm](https://www.npmjs.com/package/meilisearch).
159
170
160
171
💡 If you need to release a new beta for the same version (i.e. `vX.X.X-beta.1`):
0 commit comments