Please - Simple is better

From: Date: Sat, 16 Aug 2003 01:37:57 +0000
Subject: Please - Simple is better
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969355808@lists.php.net to get a copy of this message
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. -- > PHP Arabization Forum: (http://www2.php4arab.info/doc.ar.list/) > Dictionary: (http://www2.php4arab.info/acronyms)

« previous php.doc (#969355808) next »