On 09/14/2017 12:03 PM, Michał Górny wrote: > Hi, everyone. > > Following the backporting of all GLEP changes from the wiki to my draft > repository [1] (which is still open for a separate review), I have > prepared an update for GLEP 1 & 2. For your convenience, the update > is both sent as git patches in reply to this mail, and provided > as a GH pull request [2]. > > The notable changes are: > > 1. A new git-based workflow is introduced that is a combination > of the old CVS workflow and the MW workflow (wrt access > restrictions). The developers create branches or fork the GLEP > repository, and work on their drafts there. GLEP editors merge > changes into master to make them official. > > 2. The old ReST markup is restored. Previously, GLEPs allowed also > GuideXML but this is not supported anymore. > > 3. The complete set of GLEP headers is restored, and they are updated > for the modern workflow: > > - Last-Updated needs to be set manually, > - Version is updated manually and is semantic, > - all dates use ISO 8601 (GLEP 45). > > 4. Two minor changes are made for better interoperability (i.e. less > custom code and better support for external tools): > > - source files are renamed from .txt to .rst, > - headers are surrounded by '---' to be compatible with YAML Front > Matter. > > 5. GLEP workflow is updated to account for additional statuses in use: > > - 'Withdrawn' when author withdraws the GLEP (used in 4 GLEPs), > - 'Moribund' when GLEP is obsoleted without a replacement > (historically used in 1 GLEP but the need was discussed recently). > > Please review and comment. > > [1]:https://github.com/gentoo/glep-draft/pull/1 > [2]:https://github.com/gentoo/glep-draft/pull/2 > > -- > Best regards, > Michał Górny > > Looks good. Migrating to purely text files, independent of framework, is a good step forward. K-9 zapped a mail I tried to send to you in another reply saying such, so I felt it best to repeat it here. I like how we're referencing and leveraging existing standards to improve interoperability. If I had to find a nitpick, it's a minor feature request: can we get a GLEP template file later on, to aid the initial drafting process? I didn't see it in the repo. -- Daniel Campbell - Gentoo Developer, Trustee, Treasurer OpenPGP Key: 0x1EA055D6 @ hkp://keys.gnupg.net fpr: AE03 9064 AE00 053C 270C 1DE4 6F7A 9091 1EA0 55D6