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

> From: Roman Neuhauser [mailto:neuhauser@bellavista.cz] > Sent: Friday, June 13, 2003 12:31 PM > > # paj@pearfr.org / 2003-06-13 11:38:16 +0200: > 1. The relationships between tools and tasks should ideally be 1:1. > The more specialized a tool is the better it can be in doing its > job. I agree. Therefore it should be examined if splitting phpdocumentator into more specialized components is a solution. I guess Pierre's suggestion is not to much about making phpdocumentor the one size fits all solution but reusing the technology that is already inside phpdocumentator to make this a lot easier. > 2. There's nothing wrong with using programs written in languages > other than PHP. Fanatism isn't the best thing under the sun. 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. > 3. Don't reinvent the wheel when it's not necessary. I understand > from previous posts that the tools are mature, so why not use them? See above. Regards, Lukas