From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id BA2E61396D0 for ; Fri, 15 Sep 2017 06:40:57 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id CE45FE0C31; Fri, 15 Sep 2017 06:40:56 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 9D5BDE0BFD for ; Fri, 15 Sep 2017 06:40:56 +0000 (UTC) Received: from pomiot (d202-252.icpnet.pl [109.173.202.252]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: mgorny) by smtp.gentoo.org (Postfix) with ESMTPSA id 9E54933BEAE; Fri, 15 Sep 2017 06:40:54 +0000 (UTC) Message-ID: <1505457651.2185.11.camel@gentoo.org> Subject: GLEP non-compliance report (was: [gentoo-project] [RFC] GLEP 1/2 updates for the new old-school GLEP workflow) From: =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?= To: gentoo-project@lists.gentoo.org Date: Fri, 15 Sep 2017 08:40:51 +0200 In-Reply-To: <20170914190326.12168-1-mgorny@gentoo.org> References: <20170914190326.12168-1-mgorny@gentoo.org> Organization: Gentoo Content-Type: text/plain; charset="UTF-8" X-Mailer: Evolution 3.24.5 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Project discussion list X-BeenThere: gentoo-project@lists.gentoo.org Reply-To: gentoo-project@lists.gentoo.org Mime-Version: 1.0 Content-Transfer-Encoding: 8bit X-Archives-Salt: 5faee990-4ff8-4f14-9615-50a551863668 X-Archives-Hash: bf49b2dc921d06517a2816d06a208b16 W dniu czw, 14.09.2017 o godzinie 21∶03 +0200, użytkownik Michał Górny napisał: > 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). And here's a small report on what doesn't match the spec besides the obvious changes (date format, ---). Strict violations: 1. GLEPs 57..61 (@robbat2) used 'Updated' header with a list of dates that's not allowed by the spec. 2. GLEPs 59..61 (@robbat2) used 'Updates: 44', probably to indicate that they extend the format specified in GLEP 44. 3. GLEPs 31, 33, 40, 57 used 'Approved' header with a date. 4. GLEP 21 used 'Discussed-To' header for gentoo-portage-dev@ (probably a typo of 'Discussions-To'. 5. GLEP 11 used 'Discussions-To: gentoo-dev@...'. This header was explicitly removed from GLEP 1 as not very useful, and was probably used contrary to the original use anyway. 6. GLEP 4 used 'Editor' header. 7. GLEPs 10, 12 were missing 'Content-Type'. 8. GLEP 15 used 'Status: Approved', probably 'Accepted' was meant. YAML violations not strictly required by the spec: a. most of GLEPs copied between 'Author:' and the name from GLEP 2; I've replaced all of that with spaces. b. GLEPs 28 and 30 use quoted word in the beginning of the title which confuses the YAML parser. It could be solved by adding extra quoting around the whole line or using fancy quotes (“”) instead of plain "". -- Best regards, Michał Górny