diff options
Diffstat (limited to 'general-concepts')
| -rw-r--r-- | general-concepts/news/text.xml | 59 |
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> |