1 |
>>>>> On Sun, 31 Jul 2022, Thomas Bracht Laumann Jespersen wrote: |
2 |
|
3 |
> Minor language things, on the whole an easy document to read! |
4 |
>> Motivation |
5 |
>> ========== |
6 |
>> |
7 |
>> So far, old EAPIs were deprecated by the Gentoo Council in an ad-hoc |
8 |
>> manner. No fixed criteria were used, resulting in very different |
9 |
>> deprecation times after approval of newer EAPIs. Standardized |
10 |
>> criteria for deprecation and banning will make the life cycle of EAPIs |
11 |
>> more predictable. |
12 |
|
13 |
> "very different" could maybe be specified further. Something like |
14 |
> "inconsistent"/"unreliable"/"unpredictable" is more precise? |
15 |
|
16 |
>> |
17 |
>> The Gentoo Council will ban a deprecated EAPI when |
18 |
>> |
19 |
>> * 24 months have passed since its deprecation, and |
20 |
>> * it is used by less than 5 % of ebuilds in the Gentoo repository. |
21 |
|
22 |
> Should be "fewer than 5 %". |
23 |
|
24 |
>> |
25 |
>> A delay of 24 months between deprecation and ban will give ebuild |
26 |
>> authors enough time to update. This is especially relevant for |
27 |
>> overlays and downstream distributions. Since a banned EAPI is |
28 |
>> sufficient reason for updating an ebuild, an additional threshold of |
29 |
>> 5 % is required, in order to keep the number of such updates (and bug |
30 |
>> reports requesting them) manageable. |
31 |
|
32 |
> Two things: |
33 |
|
34 |
> "Since" has a temporal meaning, but is often used to mean "although". Maybe |
35 |
> "although" is a better word here? |
36 |
|
37 |
> I would drop the ", in order" and make it simply "[…] an additional threshold |
38 |
> of 5% is required to keep the number […]" |
39 |
|
40 |
Thanks, should be all fixed. Updated version will follow. |
41 |
|
42 |
Ulrich |