general-concepts/news/text.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

<?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="https://wiki.gentoo.org/wiki/GLEP:42">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>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>

</chapter>
</guide>