"not up-to-date" notices for manual page translations
| From: | Christoph Becker | Date: | Fri, 20 Mar 2015 20:39:05 +0000 |
| Subject: | "not up-to-date" notices for manual page translations | ||
| Groups: | php.doc php.webmaster | ||
| Request: | Send a blank email to php-webmaster+get-20928@lists.php.net to get a copy of this message | ||
Hi everybody!
I suggest to display prominent notices on non English manual pages which
are not up-to-date. Something like "Note: The translation of this page
is not up-to-date".
My reasoning is that out-dated translations may be missing important
details and might be even wrong, but the reader won't notice. Consider,
for instance, CURL_SSLVERSION. On the English manual page[1] there is
following important note:
| Setting it to 2 or 3 is very dangerous given the known
| vulnerabilities in SSLv2 and SSLv3.
The German manual page[2], however, states:
| Ein Wert von 2 oder 3 wählt die entsprechende SSL-Version.
(A value of 2 or 3 selects the respective SSL version.)
I presume that a "not up-to-date" notice could be generated from the XML
sources of the documentation.
Any comments are appreciated.
[1] <http://php.net/manual/en/function.curl-setopt.php>
[2] <http://php.net/manual/de/function.curl-setopt.php>
--
Christoph M. Becker