Eddie L. Hixson wrote:
> On Wed, 2009-04-15 at 08:40 -0400, Bob Majdak Jr wrote:
>> I always love how so many people say this and so few people have/willing
> Say What? Are you referring to coding or documentation. I have seen
> many people offer to help with documentation and have been put off for
> some reason or another.
No one has been "put off" by anything - but when the things that NEED to
be done are listed people are scared off. Unfortunately the docs are
not even in a condition where you can just "fill out information in
skeletons" atm.
For the documentation
1. all the docbook needs to be updated to Docbook 5 (it's at 3 now)
there are several people in php-gtk working on this, if you want to help
contact them (best place is freenode #php-gtk)
2. someone needs to write a PhD (system that php.net uses to render
docbook) theme for php-gtk (this would be an all PHP code project)
3. the documentation reflection generator needs to be updated to
generate the new documentation - again there are people working on this,
feel free to contact them in the php-gtk irc channel
4. the actual website needs to be updated with auto-rendering documentation
In fact this project was even offered as an idea for gsoc 2009 - sadly
no takers
http://wiki.php.net/gsoc/2009I believe there is an svn repo set up with the documentation work.
Anyone willing to jump on irc, say hello, and offer some help will
gladly be recruited.
>
> Coding is all together another issue. If I was proficient enough in the
> language "C" I would help. I asked the question because I have been
> unable to build the project in months because of the cairo extensions.
You are free to build the 2.0.1 tag (php_gtk_2_0_1) instead - it doesn't
require cairo and works just fine. There are very few changes in HEAD
at the moment, mainly the cairo support.
As for C, you don't have to be all that proficient to help on the
project - if you know the basics and can copy other people's code you
can help with overrides.
PHP-GTK could also do with an automake guru - there need to be some
changes made to the configure stuff for HEAD that are not yet completed,
but we don't currently have someone skilled enough at writing m4 macros ;)
>
> I have a simple Redhat Linux Fedora 9 install and can't build.
>
> If the goal is to have people use and build on it. It has to work.
If all you need is a stable build - that's what tags in cvs are for,
they are release versions (if you ever want a really fun time, try
building PHP CVS head on a regular basis - ah the unicode madness)
>
> I always love how people become so easily offended and defensive by
> simple questions.
Actually, a lot of times people forget that open-source is done by
volunteers who don't get paid for anything and have real lives just like
everyone else. These volunteers also get inundated with whining -
people who are glad to tell you what's wrong and yet offer little help
in fixing it so they tend to be short tempered with those who genuinely
do care.
Remember, people are often glad to point you to the right places to
learn new things (C, docbook, PhD)
If you're interested in helping with php-gtk I'd HIGHLY suggest you
visit the IRC channel - it has a lot more going on than the mailing list
- or introduce yourself on the php.gtk.dev list and volunteer "I'm
willing to learn docbook/PhD/C and help out"
Thanks,
Elizabeth
>
> Eddie
>> to donate the time to do something about it.
>>
>> - bob.
>>
>>
>> Harald Thoeny wrote:
>>> the documentation on the website is a mess !
>>>
>>> we had a thread on this list with frustrated doc writers....
>>> myself is also waiting for a better doc system!
>>>
>>> greetings
>>>
>>> harald
>>>
>>> Madeleine D. wrote:
>>>>
>>>> Not really stale at all, just quiet on this list. Those who have the
>>>> skills are busy working on an update. There's a lot of daily
>>>> activity via kksou.com, some via Gnope.org and even more via IRC.
>>>>
>>>> I think part of the problem is the broken web site for gtk.php.net,
>>>> which sends people off in different directions, but so far, no luck
>>>> on getting fixed.
>>>>
>>>> Madeleine D.
>>>>
>>>>
>>>>
>>>>
>>>> Eddie L. Hixson wrote:
>>>>> Has this project become stale? What is the future of php-gtk? I hear
>>>>> no chatter from the list.
>>>>>
>>>>> Eddie
>>>>>
>>>>>
>>>>>
>>
>
--
PHP-GTK General Mailing List (
http://gtk.php.net/)
To unsubscribe, visit:
http://www.php.net/unsub.php