On Apr 6, 2010, at 12:05 PM, Rasmus Lerdorf wrote:
It's custom code for our docs, but it probably wouldn't be too hard to
bolt onto another system. Start here:
Thanks so much for the thorough summary. This is very helpful.
As to whether we'll actually do this, I don't know. Expect a certain
amount of resistance. User commentary without a concerted effort to
incorporate that commentary back into the docs is, as Robert says, a
recipe for unlimited quantities of crap attached to the docs. On the
other hand, the Apache HTTPD docs are *WAY* smaller than the PHP docs.
We have (last time I counted) a total of 229 doc files. I count
10809 .xml files in the doc-en svn repo. So incorporating that
feedback is a much smaller job than it is with the PHP docs.
Mostly I'm feeling that our docs don't answer the questions that folks
are actually asking, and I am looking around for ways to rectify that.
This is one idea that was floated.