Archive

Archive for July 16th, 2009

RB Language Reference

July 16th, 2009 7 comments

Am I the only one that think the RB Language Reference is less than useful?  Honestly, it seems about the only time I check it now is when the auto complete messes up (usually by not giving me any choices) and I want to make sure I’m not wrong on what I thought AC should show.

I’ve said it before and I’ll say it again, I think having the Language Reference online with user added comments is better solution.  In my ideal world, the local Language Reference gets the comments from the web IF I want them (and I do in most cases).  It’s a brave new world and it’s time to embrace the web (of course this means we need a new/reliable web browser control but again, that’s a different topic – see here, here, and here).

You know it’s bad when you think OPEN SOURCE documentation is better.  See Java, php, MySQL documentation for examples.

Am I wrong about this?  Or am I not looking at it from a complete newbies perspective?  Maybe the LR is good for beginners and not for experienced users because I’ve heard from various sources that new people really like the language reference.  However, I also see an awful lot of questions being answered on the forums that might have been eliminated if a simple comment or two was added in the Language Reference.

Thoughts?