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

I offer some counter points, here... 

On Wednesday 15 April 2009 06:53:48 Bob Majdak Jr wrote:
> Coding is really limping along just fine. Tonnes of people hate the
> docs, less than tonnes offer to help,  none of them actually do. 

Sometime ago, I was offered the opportunity to update the docs, and was 
picturing that it would be something like a fancy wiki or somesuch. Instead, I 
was introduced to text files with a very complicated tagging system and a steep 
learning curve. I don't remember what it was, it's been a few years, and I'm 
sure there are good reasons for choosing it. 

After struggling for some hours over a few days on it (and even starting a 
docs editor in PHP-GTK to manage some of the complexity) I threw in the towel 
and resigned myself to leaving (hopefully helpful) comments. 

Can this be made simpler? Do you know of some kind of doc-editor manager 
doohickey to take track all the tagging? 

> Granted
> extra coders would help but patch writers are easier to come across than
> people actually willing to do the docs. And the coders can usually
> figure out what to do by knowing  GTK in C or by looking at the C GTK
> manual.

Get_class_methods() and get_object_vars(), and Google are my substitutes. I 
make it a point to leave notes when I can. 

> The PHP doc system i am sure is not going anywhere, and personally I
> like comments off, it is a manual not a wbe forum.  That is one of the
> things I hate the most about the actual PHP docs, especally when a new
> guy posts a code sample that is horrid and the next 20 posts are people
> saying "oh hay i made this better". I am not being bitter. Honest.

It's common for me to be baffled by minimalist docs, only to find a comment that 
makes it all clear... I'm perfectly willing to ignore the crappy, 3-page-long 
code samples in order to have the nuggets that make my day! And sometimes, 
even the 3-page-long crappy code gives enough detail about how to use XYX 
function that it's useful. 

...perhaps a moderation system for comments? 

-- 
This message has been scanned for viruses and
dangerous content by MailScanner, and is
believed to be clean.