"not up-to-date" notices for manual page translations

[email protected] (Christoph Becker)
Newsgroups php.doc,php.webmaster
Message-ID <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.