Re: [PHP-DOC] Manual notes, languages and editor's comments From: Rasmus Lerdorf (rasmus <email protected>)
Date: 08/21/00

> I was wondering if it would be a good idea to ocassionally translate
> to English the user's notes that are in other languages. In some cases
> those notes may contain important/interesting information.
>
> BTW, what became of the idea translated manual and notes in the
> corresponding language?. The majority of responses I got from people
> in the PHP Spanish list was: "Do not exclude the notes in english from
> the translated manual pages, because they contain important/useful
> information" Only one person out of 13 thought that putting notes only
> in (for example) Spanish would be good, but it was because he thought
> that *all* notes would be translated from one language to the next
> (automagically).

Well, it is actually a little bit tricky right now the way the manual
annotations are done. I have added a language tag to each note which
language version of a page the user was on when he clicked 'add note'. Of
course, there is no way to figure out which language he wrote the note
in. And also, when adding a note to something like:

  http://www.php.net/manual/hu/manual.php

the actual entry we get is:

INSERT INTO note VALUES (7948,'PHP Kézikönyv','rasmus <email protected>','Test','2000-08-21 16:32:49',NULL,'hu');

That is, we don't actually know that an entry for 'PHP Manual' and 'PHP
Kézikönyv' are notes for different translations of the same page. For the
function reference pages the page name is the same across the different
translations so we could do something intelligent there.

-Rasmus