Adding a news item

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 04A40139082 for ; Tue, 28 Nov 2017 22:52:28 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id EC0A3E083D; Tue, 28 Nov 2017 22:52:26 +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 B9938E083D for ; Tue, 28 Nov 2017 22:52:26 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (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 2583033D3C7 for ; Tue, 28 Nov 2017 22:52:25 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 6B9CCAAF1 for ; Tue, 28 Nov 2017 22:52:23 +0000 (UTC) From: "Ulrich Müller" 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" Message-ID: <1511909430.1ca9b99efeabac3522d976ea94caef5b6b227c5d.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: 1ca9b99efeabac3522d976ea94caef5b6b227c5d X-VCS-Branch: master Date: Tue, 28 Nov 2017 22:52:23 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: a98afbbc-867e-4fc1-a7c6-af9792fb66eb X-Archives-Hash: 4431bd32c7ba71d621a6adf9882ed183 commit: 1ca9b99efeabac3522d976ea94caef5b6b227c5d Author: Ulrich Müller gentoo org> AuthorDate: Tue Nov 28 22:50:30 2017 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Tue Nov 28 22:50:30 2017 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1ca9b99e general-concepts/news: Fix XML, rewrap long lines. No text changes. general-concepts/news/text.xml | 59 ++++++++++++++++++++++++++++++------------ 1 file changed, 43 insertions(+), 16 deletions(-) diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml index 2484ea8..2961084 100644 --- a/general-concepts/news/text.xml +++ b/general-concepts/news/text.xml @@ -5,14 +5,16 @@

-Gentoo News Items were created to provide a communication medium to push critical -messages to users via the rsync tree. The original proposal for news items is outlined -in GLEP 42: Critical News Reporting. +Gentoo News Items were created to provide a communication medium to push +critical messages to users via the rsync tree. The original proposal for news +items is outlined in +GLEP 42: Critical News Reporting.

-News Items can be read using the eselect command. More information on use of this tool to -read or delete news items can be found on the news.eselect man page. +News Items can be read using the eselect command. More information on use +of this tool to read or delete news items can be found on the news.eselect +man page.

@@ -20,19 +22,44 @@ read or delete news items can be found on the news.eselect man page. Adding a news item -

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.
Write the news item, which is similar to a RFC-compliant email. Details concerning what is allowed can be found in the appropriate GLEP section. As a note: Exceptions depending on installed packages or activated profiles is possible.
Send the news item to the gentoo-dev mailing list and the Gentoo PR team (pr@gentoo.org) 72 hours in advance of commit.
Wait for corrections or feedback that your news item is not of great importance and should be revoked (can be possible).
Upon acceptance, create a detached armored GnuPG signature with gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt
Verify that your signature is correct with gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt
Create a directory structure for your item in the gentoo-news repository (git+ssh://git@git.gentoo.org/data/gentoo-news.git): YYYY/YYYY-MM-DD-name/.
Add both the news file and the signature to that directory.
Commit and push your changes to the gentoo-news repository.
+ 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. +
+ Write the news item, which is similar to a RFC-compliant email. Details + concerning what is allowed can be found in the appropriate GLEP section. + As a note: Exceptions depending on installed packages or activated + profiles is possible. +
+ Send the news item to the gentoo-dev mailing list and the Gentoo PR team + (pr@gentoo.org) 72 hours in advance of commit. +
+ Wait for corrections or feedback that your news item is not of great + importance and should be revoked (can be possible). +
+ Upon acceptance, create a detached armored GnuPG signature with + gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt +
+ Verify that your signature is correct with + gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt +
+ Create a directory structure for your item in the gentoo-news repository + (git+ssh://git@git.gentoo.org/data/gentoo-news.git): + YYYY/YYYY-MM-DD-name/. +
Add both the news file and the signature to that directory.
Commit and push your changes to the gentoo-news repository.