> We are already having trouble keeping our documentation up-to-date. > Some of it is in such a poor shape as to be laughable. Yes, it's > mostly our fault, but if we were able to generate documentation by > simply extracting it from the code. Tools exist for this, and > properly maintained, they are very useful.
I disagree and think that's backwards. To get good quality documentation, we have to WRITE good quality documentation. Using tools to generate it from sources will DECREASE its quality, in my opinion. The best measure of quality of a document is how much time people spend writing and editing it.
