Re: Requirements for Documentation System
| From: | Paul M Jones | Date: | Tue, 13 Apr 2004 01:22:13 +0000 |
| Subject: | Re: Requirements for Documentation System | ||
| References: | 1 2 3 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-3299@lists.php.net to get a copy of this message | ||
Hi, Olivier,
As for the requirements, if you're really serious about reconsidering the whole PEAR-DOC architecture (which I think is useless except for integrating Livedocs), you should add that the docs can be generated from source code, as with PHPDocumentor.I don't know if we're reconsidering the whole architecture, we just want to see what the requirements for the architecture are. If we're on-track, then great! If not, though, we need to see where we want to go before we can try to get there. The "pull from phpDocumentor" is a fantastic idea. I don't know if we want to generate the whole of the documentation from source code only, as that might present problems with integrating other sources of editing, but certainly the general idea is sound. Add new requirement: a way to integrate inline phpDocumentor tags from source code (method and purposes to be determined). -- Paul M. Jones pmjones@ciaweb.net Savant: the simple alternative to Smarty. http://phpsavant.com/