Re: Requirements for Documentation System
| From: | Paul M Jones | Date: | Sun, 18 Apr 2004 13:56:31 +0000 |
| Subject: | Re: Requirements for Documentation System | ||
| References: | 1 2 3 4 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-3612@lists.php.net to get a copy of this message | ||
Per a note from Arnaud Limbourg responding to Daniel Convissor.
Add new requirement: translated documents should note the translation source version; if based on an out-of-date source, the translated document should highlight that fact. -- Paul M. Jones pmjones@ciaweb.net Savant: the simple alternative to Smarty. http://phpsavant.com/Someone on php-dev made a good point about the PHP docs which applies to the PEAR docs as well. If an English page has been updated but a translated page has not, users should be alerted to the fact that the translation they're looking at does not contain current information.That would seem necessary indeed. I guess a tag telling which version of the original document was used could be checked on building. Can be necessary to add on the requirements list of Paul.