Re: Online doc generator
| From: | Alexander Merz | Date: | Mon, 12 Apr 2004 20:07:06 +0000 |
| Subject: | Re: Online doc generator | ||
| References: | 1 2 3 4 5 6 7 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-27489@lists.php.net to get a copy of this message | ||
Paul M Jones wrote:
"Why DocBook is good" is not the question at this point. The question really is, "What are our requirements for documentation creation, editing, and delivery?" Yes, we've been using DocBook, and it may or may not be the best tool. Let's find out. What do we need from our documentation system? The answer is *not* "a Wiki", or "reST", or "DocBook." The answer is a list of non-technology-specific requirements.Maybe i miss something, but about what are you talking exactly? The only list of answer coming up to my about 'non-technology' is: - a brain - (at least) one hand - something natural to fix your thoughts permanently like stone or leafes Everything beyond this is technology. It could be easier to understand you, if you say what your 'writing paradise' would be.