From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-992313-garchives=archives.gentoo.org@lists.gentoo.org>
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 B3A13139083
for <garchives@archives.gentoo.org>; Fri, 22 Dec 2017 11:20:53 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id EFBB0E0F46;
Fri, 22 Dec 2017 11:20:50 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
(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 D1292E0F46
for <gentoo-commits@lists.gentoo.org>; Fri, 22 Dec 2017 11:20:50 +0000 (UTC)
Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84])
(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id DBBFD341236
for <gentoo-commits@lists.gentoo.org>; Fri, 22 Dec 2017 11:20:49 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
by oystercatcher.gentoo.org (Postfix) with ESMTP id 6DB91A1A0
for <gentoo-commits@lists.gentoo.org>; Fri, 22 Dec 2017 11:20:48 +0000 (UTC)
From: "Ulrich Müller" <ulm@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" <ulm@gentoo.org>
Message-ID: <1513941569.8db770b1f0bd7f06151cf4285077695583e285f0.ulm@gentoo>
Subject: [gentoo-commits] proj/devmanual:master commit in: general-concepts/news/
X-VCS-Repository: proj/devmanual
X-VCS-Files: general-concepts/news/text.xml
X-VCS-Directories: general-concepts/news/
X-VCS-Committer: ulm
X-VCS-Committer-Name: Ulrich Müller
X-VCS-Revision: 8db770b1f0bd7f06151cf4285077695583e285f0
X-VCS-Branch: master
Date: Fri, 22 Dec 2017 11:20:48 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Archives-Salt: 7e017534-d757-4ee6-92fa-cb47f18e7542
X-Archives-Hash: 14f54b7fa4b0a7397e932ff2a84e4f38
commit: 8db770b1f0bd7f06151cf4285077695583e285f0
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Dec 21 13:52:03 2017 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Dec 22 11:19:29 2017 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=8db770b1
general-concepts/news: Bring in line with updated GLEP 42.
Acked-by: Göktürk Yüksek <gokturk <AT> gentoo.org>
Closes: https://bugs.gentoo.org/641928
general-concepts/news/text.xml | 24 ++++++++++--------------
1 file changed, 10 insertions(+), 14 deletions(-)
diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index d1af53e..06b5866 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -24,10 +24,14 @@ man page.
<ul>
<li>
- Choose a file name in the proper format: YYYY-MM-DD-name.lang.txt,
- where the date is followed by a name (a-z, 0-9, + (plus), - (hyphen)
- and _ (underscore)), the two-letter ISO language code (en for English
- must be chosen as default) and the file extension txt.
+ Choose a filename in the proper format:
+ <c>YYYY-MM-DD-shortname.lang.txt</c>, i.e. the date, followed by a very
+ short name of at most 20 characters and consisting only of <c>a-z</c>,
+ <c>0-9</c>, <c>+</c> (plus), <c>-</c> (hyphen) and <c>_</c> (underscore).
+ This is followed by <c>lang</c> which is an
+ <uri link="https://tools.ietf.org/rfc/bcp/bcp47.txt">IETF language
+ tag</uri>. Always use <c>en</c> for English, unless you are translating
+ a news item. Finally, the filename ends with the extension <c>txt</c>.
</li>
<li>
Write the news item, which is similar to a RFC-compliant email. Details
@@ -44,19 +48,11 @@ man page.
importance and should be revoked (can be possible).
</li>
<li>
- Upon acceptance, create a detached armored GnuPG signature with
- gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt
- </li>
- <li>
- Verify that your signature is correct with
- gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt
- </li>
- <li>
Create a directory structure for your item in the gentoo-news repository
(<c>git+ssh://git@git.gentoo.org/data/gentoo-news.git</c>):
- YYYY/YYYY-MM-DD-name/.
+ <c>YYYY-MM-DD-shortname/</c>.
</li>
- <li>Add both the news file and the signature to that directory.</li>
+ <li>Add the news file to that directory.</li>
<li>Commit and push your changes to the gentoo-news repository.</li>
</ul>