| 1 |
commit: 8db770b1f0bd7f06151cf4285077695583e285f0 |
| 2 |
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Thu Dec 21 13:52:03 2017 +0000 |
| 4 |
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Fri Dec 22 11:19:29 2017 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=8db770b1 |
| 7 |
|
| 8 |
general-concepts/news: Bring in line with updated GLEP 42. |
| 9 |
|
| 10 |
Acked-by: Göktürk Yüksek <gokturk <AT> gentoo.org> |
| 11 |
Closes: https://bugs.gentoo.org/641928 |
| 12 |
|
| 13 |
general-concepts/news/text.xml | 24 ++++++++++-------------- |
| 14 |
1 file changed, 10 insertions(+), 14 deletions(-) |
| 15 |
|
| 16 |
diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml |
| 17 |
index d1af53e..06b5866 100644 |
| 18 |
--- a/general-concepts/news/text.xml |
| 19 |
+++ b/general-concepts/news/text.xml |
| 20 |
@@ -24,10 +24,14 @@ man page. |
| 21 |
|
| 22 |
<ul> |
| 23 |
<li> |
| 24 |
- Choose a file name in the proper format: YYYY-MM-DD-name.lang.txt, |
| 25 |
- where the date is followed by a name (a-z, 0-9, + (plus), - (hyphen) |
| 26 |
- and _ (underscore)), the two-letter ISO language code (en for English |
| 27 |
- must be chosen as default) and the file extension txt. |
| 28 |
+ Choose a filename in the proper format: |
| 29 |
+ <c>YYYY-MM-DD-shortname.lang.txt</c>, i.e. the date, followed by a very |
| 30 |
+ short name of at most 20 characters and consisting only of <c>a-z</c>, |
| 31 |
+ <c>0-9</c>, <c>+</c> (plus), <c>-</c> (hyphen) and <c>_</c> (underscore). |
| 32 |
+ This is followed by <c>lang</c> which is an |
| 33 |
+ <uri link="https://tools.ietf.org/rfc/bcp/bcp47.txt">IETF language |
| 34 |
+ tag</uri>. Always use <c>en</c> for English, unless you are translating |
| 35 |
+ a news item. Finally, the filename ends with the extension <c>txt</c>. |
| 36 |
</li> |
| 37 |
<li> |
| 38 |
Write the news item, which is similar to a RFC-compliant email. Details |
| 39 |
@@ -44,19 +48,11 @@ man page. |
| 40 |
importance and should be revoked (can be possible). |
| 41 |
</li> |
| 42 |
<li> |
| 43 |
- Upon acceptance, create a detached armored GnuPG signature with |
| 44 |
- gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt |
| 45 |
- </li> |
| 46 |
- <li> |
| 47 |
- Verify that your signature is correct with |
| 48 |
- gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt |
| 49 |
- </li> |
| 50 |
- <li> |
| 51 |
Create a directory structure for your item in the gentoo-news repository |
| 52 |
(<c>git+ssh://git@××××××××××.org/data/gentoo-news.git</c>): |
| 53 |
- YYYY/YYYY-MM-DD-name/. |
| 54 |
+ <c>YYYY-MM-DD-shortname/</c>. |
| 55 |
</li> |
| 56 |
- <li>Add both the news file and the signature to that directory.</li> |
| 57 |
+ <li>Add the news file to that directory.</li> |
| 58 |
<li>Commit and push your changes to the gentoo-news repository.</li> |
| 59 |
</ul> |
Archives