Re: Please - Simple is better

On Fri, 2003-08-15 at 18:37, Hafid wrote: > Hi, > I want to make some remarks concerning the PHP Documentation > but I'm afraid to make someone angry. These remarks are > based on my efforts to translate the documentation. I also remarked that the > same problems were lived by other translation groups but I don't know if > they did the above remarks. So finally, I think these remarks are worthy. > > I want to ask you to simplify texts: you are not obliged to use statements > inside statements. It is not a general rule: but sometimes when I find them > I really stay a lot of time trying just to understand the meaning, and I'm > sure I'm not the only one. Just simplify at the maximum. Please. > > Try to make sentences the easiest possible: sometimes it's very hard to > translate couples like this: > example 1 >> Must be writable by whatever user PHP is running as. > example 2 >> The following table describes some of the extensions available > and required additional dlls. You don't need to translate them word-for-word; it's more important to get the meaning across, and if you have to modify it to make it make sense in another language, go ahead. That said, if you ever need a hand getting the sense of something, mention it here and someone will probably help you out (and maybe even clarify it in the original text, if it is indeed poorly written). -- Torben Wilson <torben@php.net> +1.604.709.0506 http://www.thebuttlesschaps.com http://www.inflatableeye.com http://www.hybrid17.com http://www.themainonmain.com -----==== Boycott Starbucks! http://www.haidabuckscafe.com ====-----