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

-- 
PHP Webmaster List Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to