| 1 |
Hi GDP-related entities, |
| 2 |
as promised on IRC, here are my ideas about $SUBJECT. |
| 3 |
|
| 4 |
Currently we have quite a lot of "unsupported"/"invalid"/"unmaintained" |
| 5 |
documents for one of these reasons: |
| 6 |
|
| 7 |
a) Third party article |
| 8 |
b) Older Handbook |
| 9 |
c) Translation in language which is not officially supported |
| 10 |
d) Outdated translation |
| 11 |
|
| 12 |
First three cases are easily detectable, fourth can't be checked easily |
| 13 |
("what is outdated translation?"), AFAIK & IMHO. |
| 14 |
|
| 15 |
So, the proposed change is to modify the XSL stylesheet to include some |
| 16 |
bold red warning (with proper i18n, if possible) stating that the |
| 17 |
document is no longer/not yet/... supproted, for example: |
| 18 |
|
| 19 |
a) "This article is not part of the official Gentoo documentation, it |
| 20 |
has been republished on our site only for your convenience and with |
| 21 |
permisson of the respective copyright owner. It may not reflect current |
| 22 |
state of things and could be outdated." |
| 23 |
|
| 24 |
b) "This Handbook is no longer maintained and is left here only for your |
| 25 |
convenience, please don't bother with submitting bugreports. In case you |
| 26 |
are looking for networkless installation instructions, please consult |
| 27 |
<link>current handbook</link>." |
| 28 |
|
| 29 |
c) "This language is not backed up by an official Translation Team and |
| 30 |
might be outdated or even incorrect. In doubts please consult |
| 31 |
[link]original document[/link]." |
| 32 |
|
| 33 |
Some random resources: |
| 34 |
http://bugs.gentoo.org/show_bug.cgi?id=105248 - l-posix3.xml: |
| 35 |
control_destroy() calls pthread_cond_destroy() twice |
| 36 |
|
| 37 |
All opinions are welcome. |
| 38 |
|
| 39 |
-jkt |
| 40 |
|
| 41 |
-- |
| 42 |
cd /local/pub && more beer > /dev/mouth |
Archives