Re: [PHP-GTK] Status of PHP-GTK
[email protected] (Steph) Fri, 17 Apr 2009 16:06:11 +0100
| Newsgroups | php.gtk.general |
|---|---|
| Message-ID | <[email protected]> |
Andrei Zmievski wrote: > Elizabeth M Smith wrote: >>> 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. > > It sounds to me like the current doc system is a big barrier to entry > for those who want to contribute to the documentation. 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 my > 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 >