Re: Requirements for Documentation System

From: 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.
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.
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/

« previous php.pear.doc (#3612) next »