* [gentoo-commits] proj/devmanual:master commit in: appendices/contributors/, general-concepts/news/, general-concepts/
@ 2011-09-17 8:06 Markos Chandras
0 siblings, 0 replies; only message in thread
From: Markos Chandras @ 2011-09-17 8:06 UTC (permalink / raw
To: gentoo-commits
commit: d97009116933f7be2ac4dafce7c378d1bb79510e
Author: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
AuthorDate: Sat Sep 17 08:03:59 2011 +0000
Commit: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sat Sep 17 08:03:59 2011 +0000
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=d9700911
Document the process to add news item thanks to Mike Pagano
* Original patch from Mike Pagano <mpagano <AT> gentoo.org>
* This fixes bug #365189
---
appendices/contributors/text.xml | 3 ++
general-concepts/news/text.xml | 39 ++++++++++++++++++++++++++++++++++++++
general-concepts/text.xml | 1 +
3 files changed, 43 insertions(+), 0 deletions(-)
diff --git a/appendices/contributors/text.xml b/appendices/contributors/text.xml
index 7e3202c..89b9156 100644
--- a/appendices/contributors/text.xml
+++ b/appendices/contributors/text.xml
@@ -56,6 +56,9 @@ This page lists the contributions to the Gentoo Development Guide:
<author name="Mark Loeser" email="halcy0n@gentoo.org">
XSL Stylesheets, current maintainer
</author>
+<author name="Mike Pagano" email="mpagano@gentoo.org">
+ <uri link="::general-concepts/news"/>
+</author>
</authors>
</body>
diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
new file mode 100644
index 0000000..77671fb
--- /dev/null
+++ b/general-concepts/news/text.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0"?>
+<guide self="general-concepts/news/">
+<chapter>
+<title>News Items</title>
+
+<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="http://www.gentoo.org/proj/en/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.
+</p>
+</body>
+
+<section>
+<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>Create a directory structure for your item in the Gentoo News repository gentoo-news: YYYY (e.g. 2011 for a news item published in 2011).</li>
+ <li>Add both the signature and the news file to that directory.</li>
+ <li>Commit both items to the svn gentoo-news repository.</li>
+</ul>
+</p>
+</body>
+</section>
+
+</chapter>
+</guide>
diff --git a/general-concepts/text.xml b/general-concepts/text.xml
index da69b7b..108fe00 100644
--- a/general-concepts/text.xml
+++ b/general-concepts/text.xml
@@ -34,6 +34,7 @@ writing ebuilds or working with the Portage tree.
<include href="licenses/"/>
<include href="linguas/"/>
<include href="mirrors/"/>
+<include href="news/"/>
<include href="overlay/"/>
<include href="pic/"/>
<include href="portage-cache/"/>
^ permalink raw reply related [flat|nested] only message in thread
only message in thread, other threads:[~2011-09-17 8:07 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-09-17 8:06 [gentoo-commits] proj/devmanual:master commit in: appendices/contributors/, general-concepts/news/, general-concepts/ Markos Chandras
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox