Re: Getting more people involved.. bye bye Docbook

From: Date: Tue, 13 Aug 2013 09:14:53 +0000
Subject: Re: Getting more people involved.. bye bye Docbook
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969384574@lists.php.net to get a copy of this message
On 10/08/13 07:34, Hannes Magnusson wrote:
I've been thinking lately about how we can make it easier for people to contribute to the project.. The OE was a great improvement and made it whole lot simpler to get going for users and did its job pretty well. Editing xml however isn't something the general public seems to be willing to do, not to mention they have no idea what docbook is at all. Other pain points are how long it takes to validate and build the documentation - and the cheesy tricks we've had to deploy to squeeze every performance drop out of both PHP and XML. If you guys remember our story.. DSSSL rendering took _days_ to build. XSLT took _hours_. PhD takes _minutes_. I think we can do better. I want it down to _seconds_.
Have you people considered simply moving the documentation to a wiki? For example, MediaWiki? * Build time in seconds. * Wikitext syntax is as simple as any other presented so far. * Has templating system that is needed. * Has RTL support. * Has PHP code formatting for code examples.

« previous php.doc (#969384574) next »