Re: [PHP-GTK] Status of PHP-GTK

Right now, I (FrozenFire), mgdm, and leon are working on generating the 
documentation. I have patched the phpdoc docgen.php script to generate 
docs for PHP-GTK, except for non-standard stuff like signals.

What we _really_ need is for someone who is quite fluent in the main 
documentation system to lend a hand. I am quite well versed in PHP-GTK, 
but I know next to nothing about the documentation system. If someone 
can pop onto #php-gtk on Freenode, we can get the documentation updated 
in a matter of days.

Thanks,
Justin Martin

Steph wrote:
> 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
>>