diff options
| author |   Markos Chandras <hwoarang@gentoo.org> | 2011-09-17 11:03:59 +0300 |
|---|---|---|
| committer | Markos Chandras <hwoarang@gentoo.org> | 2011-09-17 11:03:59 +0300 |
| commit | d97009116933f7be2ac4dafce7c378d1bb79510e (patch) | |
| tree | eb3dea745f037003aa42b8b5412143bfc4c87af8 /general-concepts | |
| parent | define variables in global scope since env in pkg_pretend is not (diff) | |
| download | devmanual-d97009116933f7be2ac4dafce7c378d1bb79510e.tar.gz devmanual-d97009116933f7be2ac4dafce7c378d1bb79510e.tar.bz2 devmanual-d97009116933f7be2ac4dafce7c378d1bb79510e.zip | |
Document the process to add news item thanks to Mike Pagano
* Original patch from Mike Pagano <mpagano@gentoo.org>
* This fixes bug #365189
Diffstat (limited to 'general-concepts')
| -rw-r--r-- | general-concepts/news/text.xml | 39 | ||||
| -rw-r--r-- | general-concepts/text.xml | 1 |
2 files changed, 40 insertions, 0 deletions
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/"/> |