Re: RE: [PEAR-DOC] Re: [PEAR-DEV] looking for volunteers phpDocumentor, new converter reST

On Fri, Jun 13, 2003 at 12:38:43PM +0200, Lukas Smith wrote: > True, however it is also important to keep tools needed to a minimum. > Its probably safe to assume that people writing docs have a running php > version. However its not so safe to assume that they have python, so it > adds yet another tool to the list. The question is if the drawbacks of > this are offset by the work needed to write and maintain our own > implementation. One of the major advantages to using a simple format like reST is the removal of the requirement that the documentation be "rendering" in order for it to be readable. In other words, it's entirely possible to author completely readable reST documents without ever rendering them using docutils. Given this point, there's really no requirement for PEAR developers to ever install Python (or whatever document rendering we settle on) in order for them to edit or proof their document; it's entirely readable in its native form. -- Jon Parise (jon@php.net) :: The PHP Project (http://www.php.net/)