blob: 29610846bcf9d2125341bfb8e7e2eeee68a1272d (
plain)
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
<?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://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.
</p>
</body>
<section>
<title>Adding a news item</title>
<body>
<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>
</body>
</section>
</chapter>
</guide>
|