aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'general-concepts/news/text.xml')
-rw-r--r--general-concepts/news/text.xml59
1 files 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 @@
<body>
<p>
-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 <uri link="https://www.gentoo.org/glep/glep-0042.html">GLEP 42: Critical News Reporting.</uri>
+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 <uri link="https://www.gentoo.org/glep/glep-0042.html">
+GLEP 42: Critical News Reporting.</uri>
</p>
<p>
-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.
</p>
</body>
@@ -20,19 +22,44 @@ read or delete news items can be found on the news.eselect man page.
<title>Adding a news item</title>
<body>
-<p>
<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.</li>
- <li>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.</li>
- <li>Send the news item to the gentoo-dev mailing list and the Gentoo PR team (pr@gentoo.org) 72 hours in advance of commit.</li>
- <li>Wait for corrections or feedback that your news item is not of great 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/.</li>
- <li>Add both the news file and the signature to that directory.</li>
- <li>Commit and push your changes to the gentoo-news repository.</li>
+ <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.
+ </li>
+ <li>
+ 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.
+ </li>
+ <li>
+ Send the news item to the gentoo-dev mailing list and the Gentoo PR team
+ (pr@gentoo.org) 72 hours in advance of commit.
+ </li>
+ <li>
+ Wait for corrections or feedback that your news item is not of great
+ 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/.
+ </li>
+ <li>Add both the news file and the signature to that directory.</li>
+ <li>Commit and push your changes to the gentoo-news repository.</li>
</ul>
-</p>
+
</body>
</section>