1 |
Hi, everyone. |
2 |
|
3 |
Following the backporting of all GLEP changes from the wiki to my draft |
4 |
repository [1] (which is still open for a separate review), I have |
5 |
prepared an update for GLEP 1 & 2. For your convenience, the update |
6 |
is both sent as git patches in reply to this mail, and provided |
7 |
as a GH pull request [2]. |
8 |
|
9 |
The notable changes are: |
10 |
|
11 |
1. A new git-based workflow is introduced that is a combination |
12 |
of the old CVS workflow and the MW workflow (wrt access |
13 |
restrictions). The developers create branches or fork the GLEP |
14 |
repository, and work on their drafts there. GLEP editors merge |
15 |
changes into master to make them official. |
16 |
|
17 |
2. The old ReST markup is restored. Previously, GLEPs allowed also |
18 |
GuideXML but this is not supported anymore. |
19 |
|
20 |
3. The complete set of GLEP headers is restored, and they are updated |
21 |
for the modern workflow: |
22 |
|
23 |
- Last-Updated needs to be set manually, |
24 |
- Version is updated manually and is semantic, |
25 |
- all dates use ISO 8601 (GLEP 45). |
26 |
|
27 |
4. Two minor changes are made for better interoperability (i.e. less |
28 |
custom code and better support for external tools): |
29 |
|
30 |
- source files are renamed from .txt to .rst, |
31 |
- headers are surrounded by '---' to be compatible with YAML Front |
32 |
Matter. |
33 |
|
34 |
5. GLEP workflow is updated to account for additional statuses in use: |
35 |
|
36 |
- 'Withdrawn' when author withdraws the GLEP (used in 4 GLEPs), |
37 |
- 'Moribund' when GLEP is obsoleted without a replacement |
38 |
(historically used in 1 GLEP but the need was discussed recently). |
39 |
|
40 |
Please review and comment. |
41 |
|
42 |
[1]:https://github.com/gentoo/glep-draft/pull/1 |
43 |
[2]:https://github.com/gentoo/glep-draft/pull/2 |
44 |
|
45 |
-- |
46 |
Best regards, |
47 |
Michał Górny |