Re: Status of PHP-GTK
| From: | Steph | Date: | Fri, 17 Apr 2009 15:06:11 +0000 |
| Subject: | Re: Status of PHP-GTK | ||
| References: | 1 2 3 4 5 6 7 8 9 10 11 12 13 | Groups: | php.gtk.general |
| Request: | Send a blank email to php-gtk-general+get-8403@lists.php.net to get a copy of this message | ||
Andrei Zmievski wrote:
Elizabeth M Smith wrote:It sounds to me like those who want to contribute to the documentation would rather do it in a user-notes kinda way than actually contribute to the documentation. I.e. not need to do the background work like checking the GTK manual or source, kind of thing. That's totally understandable, but I think blaming the use of XML is a bit mean when really it's the lack of user notes that's the issue. To summarize myIt sounds to me like the current doc system is a big barrier to entry for those who want to contribute to the documentation.I'd be inclined to branch php-gtk-doc now and adapt the current serverside scripts to use that branch while work's in progress on upgrading to v5 in HEAD. In that case, it'd be best to get the sysadmin to hit on everything at the same time rather than pester him twice over.Sounds good.
feelings on this subject: I'd rather have a non-php.net-standard doc system that works and allows easy contributions that be stuck in the current rut.Keeping a php.net-standard system means there are always people capable of fixing it when it breaks. Right now, keeping a php.net-standard system also means we should get access to phd, which is a fast-rendering PHP based manual build system (no extra tools required, no not even xsltproc). That factor alone makes it a good investment; the current work on live editing, I'm less convinced about, unless I've misunderstood something major. (Mirrors????) - Steph
-Andrei