Gentoo Archives: gentoo-project

From: "Michał Górny" <mgorny@g.o>
To: gentoo-project@l.g.o
Subject: [gentoo-project] [RFC] GLEP 1/2 updates for the new old-school GLEP workflow
Date: Thu, 14 Sep 2017 19:03:39
Message-Id: 20170914190326.12168-1-mgorny@gentoo.org
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

Replies

Subject Author
[gentoo-project] [PATCH 01/18] glep-0001: Update for the git workflow "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 02/18] glep-0001: Revert back to ReST markup "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 03/18] glep-0001: Restore most of old GLEP headers "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 04/18] glep-0001: Reform Last-Updated to be updated manually "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 05/18] glep-0001: Provide a meaningful versioning for GLEPs "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 06/18] glep-0001: Clarify the process on updating Replaced-By "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 07/18] glep-0001: Replace dates with ISO 8601 "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 08/18] glep-0001: Require .rst suffix for interoperability "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 09/18] glep-0001: Require --- around preamble for interoperability "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 10/18] glep-0001: Add 'Withdrawn' status to workflow "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 11/18] glep-0001: Add a "Moribund" status for obsolete GLEPs "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 12/18] glep-0001: Sync the RFC no to 2822 between sections "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 13/18] glep-0001: Do not require a specific header order "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 14/18] glep-0001: Make Content-Type obligatory "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 15/18] glep-0001: Add myself as co-author "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 16/18] glep-0002: Revert to ReST version "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 17/18] glep-0002: Update headers per GLEP 1 changes (example) "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 18/18] glep-0045: Mark Final since GLEP 1 now uses ISO 8601 dates "Michał Górny" <mgorny@g.o>
Re: [gentoo-project] [RFC] GLEP 1/2 updates for the new old-school GLEP workflow Daniel Campbell <zlg@g.o>
[gentoo-project] [PATCH 19/18] glep-0001: Require YAML conformance from the preamble "Michał Górny" <mgorny@g.o>
Re: [gentoo-project] [RFC] GLEP 1/2 updates for the new old-school GLEP workflow "Robin H. Johnson" <robbat2@g.o>
GLEP non-compliance report (was: [gentoo-project] [RFC] GLEP 1/2 updates for the new old-school GLEP workflow) "Michał Górny" <mgorny@g.o>
[gentoo-project] [PATCH 20/18] glep-0001: Attempt a more logical ordering of GLEP headers "Michał Górny" <mgorny@g.o>