Skip to content

Commit 1ee94bf

Browse files
committed
Introduce changes from review made by @bidoubiwa
1 parent f3d76b3 commit 1ee94bf

File tree

1 file changed

+20
-20
lines changed

1 file changed

+20
-20
lines changed

resources/tiers.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,35 +2,34 @@
22

33
The objective of Meilisearch's Integrations Team is to **ease Meilisearch usage to as many developers as possible**.
44

5-
Given this statement, **tiers** are nothing more than a __group of SDKs/integrations__ where the integrations team can fairly divide their attention. Unfortunately is not possible to keep all the SDKs 100% updated against the new Meilisearch releases all the time, the Integrations Team is a polyglot small team that maintains 30+ different integrations and tools, so it is humanly impossible to consistently meet the Meilisearch quality standards.
5+
Given this statement, **tiers** are nothing more than a __group of SDKs/integrations__ where the Integrations Team can fairly divide their attention. Unfortunately is not possible to keep all the SDKs 100% updated against the new Meilisearch releases all the time. The Integrations Team is a polyglot small team that maintains 30+ different integrations and tools, so it is humanly impossible to consistently meet the Meilisearch quality standards.
66

7-
The ultimate goal of introducing tiers is to allow the team to have more time for new projects/integrations so that more time can be invested and more users will be impacted.
7+
The ultimate goal of introducing tiers is to allow the team to have more time to invest in new projects/integrations to impact more users.
88

9-
It's been using [data collected here](https://docs.meilisearch.com/learn/what_is_meilisearch/telemetry.html) and data like GitHub stars, forks, and watchers to measure the impact of an SDK.
9+
To measure the impact of an SDK, the data came from different places like [telemetry](https://docs.meilisearch.com/learn/what_is_meilisearch/telemetry.html) and GitHub's stars, forks, and watchers.
1010

11-
It is worth remembering that this priority is just a concept introduced by the team where it aims to give a decision weight before
12-
we invest time in some issues of some SDK in question.
11+
It is worth remembering that this priority is just a concept introduced by the team that aims to give a decision weight before investing time in some issues of the SDKs. So it does not mean we will never work on feature requests from the bottom tiers anymore, but it says we will prioritize the top tiers most of the time transparently.
1312

14-
:warning: We will keep all officially maintained SDKs **working**. :warning:
13+
:warning: The team will still keeping all officially maintained SDKs **working**. :warning:
1514

1615
## Tier #1
1716

18-
The SDKs in group #1 have total priority over the team's time. Issues are visited before issues are present in tier #2, for example.
19-
It is worth remembering that this does not mean open issues will be finalized promptly. Every issue needs time to be understood/confirmed/worked on, and consequently closed.
20-
All new Meilisearch features that make sense for those SDKs will be available in the release day.
17+
The SDKs in group #1 have total priority over the team's time. For example, issues are visited before issues are present in tier #2.
18+
It is worth remembering that this does not mean open issues are addressed and fixed promptly. Every issue needs time to be understood/confirmed/worked on, and consequently closed.
19+
All new Meilisearch features that make sense for those SDKs will be available on the release day.
2120

2221
## Tier #2
2322

2423
Tier #2 SDKs are the emergent ones, we strongly believe they can move further, and we are betting on them.
25-
In any case, since they do not bring that much value compared to tier #1 we will only apply the amount of time required to keep it working and do important maintenance code and code cleanup.
24+
In any case, since they bring less value compared to tier #1 we only spend the amount of time required to keep it working and just do essential maintenance code and code cleanup.
2625

27-
Only in urgent cases where, for example, the SDK is no longer working issues from the SDKs in group #2 will be prioritized in comparison to tier #1.
26+
Only in urgent cases where, for example, the SDK is no longer working, issues from the SDKs in group #2 are prioritized over tier #1.
2827

2928

3029
## Tier #3
3130

3231
The SDKs in group #3 have relatively low user adoption compared to groups #2 and #1. They are probably new or have a small community behind the tech stack in the first place.
33-
As with tier #2 SDKs in this group will be prioritized only in critical cases, and they are not going to receive active improvements from the integrations team.
32+
As with tier #2 SDKs in this group will be prioritized only in critical cases, and they are not going to receive active improvements from the Integrations Team.
3433

3534
This is a very special group because we really need help from the community here.
3635

@@ -59,26 +58,27 @@ Vuepress | #3 |
5958
Gatsby | #3 |
6059

6160
## FAQ
62-
### How will the tiers be organized?
61+
### How are the tiers organized?
6362

6463
The method used is mostly manual and subjective, where we use the data previously collected from the [telemetry](https://docs.meilisearch.com/learn/what_is_meilisearch/telemetry.html) and Github to generate groups.
6564

66-
At first there are only 3 tiers, and in the future this number may change.
65+
To begin we only have 3 tiers, in the future, this number may change.
6766

68-
### Is it possible for an SDK to be moved up a level?
67+
### Is it possible for an SDK to move up a level?
6968

70-
Yes, fully possible! Especially if the team detects that more users are interested and definitely using it.
69+
Yes, fully possible! Especially if the team detects that more users are interested in and using it.
7170
Whenever a anomaly is detected, a change can be submitted to the `integration-guides` and the groups will be modified to better manage the team's time. The reassessment of the tiers will be carried out every release cycle (8 weeks).
7271

73-
### How to identify that an SDK belongs to some level?
72+
The other way around is also valid. A SDK can move to less important tiers. :shipit:
7473

75-
It is possible by accessing the README.md of each repository, and it will contain a tier badge
76-
below the Meilisearch logo, this badge says: "tiers #1", "tiers #2" and "tiers #3" like this:
74+
### How to identify which tier an SDK belongs to?
75+
76+
It is possible by accessing the README.md of each repository. A tier badge is present below the Meilisearch logo. The badge can have the following values: "tiers #1", "tiers #2" and "tiers #3". For example:
7777

7878
[![tiers - #1](https://img.shields.io/static/v1?label=tiers&message=%231&color=blue)](https://github.com/meilisearch/integration-guides/blob/main/resources/tiers.md)
7979
[![tiers - #2](https://img.shields.io/static/v1?label=tiers&message=%231&color=2ea44f)](https://github.com/meilisearch/integration-guides/blob/main/resources/tiers.md)
8080
[![tiers - #3](https://img.shields.io/static/v1?label=tiers&message=%231&color=critical)](https://github.com/meilisearch/integration-guides/blob/main/resources/tiers.md)
8181

8282
#### Why SDKs are present in a particular tier?
8383

84-
Because those SDKs have the most active users whether in the Meilisearch Cloud or not. Also they have a larger or broader community in general. Other principles could be used to move SDKs around if we think is the right thing to do.
84+
Because those SDKs have the most active users. Not only from users using the Meilisearch Cloud. They have a larger community in general. Other principles could be used to move SDKs around if we think it is relevant.

0 commit comments

Comments
 (0)