Comments on starting with Ruby

Very quickly, with no attempt at eloquence at all...

Tremendously good points:

* The language design is an excellent balance between power and
friendliness and intuitive behaviour and logically consistently
behaviour. It's more likeable even than Smalltalk.

* Well-implemented blocks, multiple assignment and return values,
mix-ins.

* The core library seems particularly well-designed. It's consistent,
powerful, well-structured, and not over-bloated. I hope that Ruby
never degenerates into the hell of the Common Lisp libraries thorough
trying to do too much.

* Excellent language documentation in the form of the Pragmatic book -
perhaps the best there is for starting any language

* Very quick to code in, easy to write comprehensible code, no
mis-features like Perl's Masonic variable prefixes

Very bad points:

* Poor documentation and questionable reliability of basic tools -
possibly this is more of an issue for Windows users? Eg I had to do a
newsgroup search to find out how to load a ruby file and change
directory in IRB (a user with less experience of dynamic and
intrepreted langauges might not have known that doing so was likely to
be possible, off course, so would never have done the search), no docs
on how to use the debugger in FreeRIDE, said debugger not being able
to show the value of variables, confusing help in the Ruby GDB style
debugger. The upsetting thing is that these are all issues that are
especially likely to lose potential new users, who will often be
testing Ruby against very stable and well documented Python tools.

If such basic tools and docs are shakey they can create FUD that
affects potential users' view of the whole language. A couple of extra
paragraphs on IRB in the Pragmatic book, pulling FreeRIDE (or
disabling the debugger) in the Windows distribution until the debugger
is usable, and a few extra sentences in the Ruby GDB-ish debugger's
help could make a huge difference to how the language spreads. (And
yes I would be willing to write the extra "gotcha" text for debugger
and IRB - who do I speak to about that?)

# irb.rb - intaractive ruby
# $Release Version: 0.7.3 $
# $Revision: 1.2 $
# $Date: 2002/11/19 02:00:18 $
# by Keiju ISHITSUKA(keiju(AT)ishitsuka(DOT)com)

FreeRide (impressive list btw, most of whom probably just read this):
http://freeride.rubyforge.org/wiki/wiki.pl?DeveloperList

···

On Fri, 25 Feb 2005 01:35:01 +0900, JC <umptious@gmail.com> wrote:

If such basic tools and docs are shakey they can create FUD that
affects potential users' view of the whole language. A couple of extra
paragraphs on IRB in the Pragmatic book, pulling FreeRIDE (or
disabling the debugger) in the Windows distribution until the debugger
is usable, and a few extra sentences in the Ruby GDB-ish debugger's
help could make a huge difference to how the language spreads. (And
yes I would be willing to write the extra "gotcha" text for debugger
and IRB - who do I speak to about that?)

--
Bill Guindon (aka aGorilla)

* JC <umptious@gmail.com> [0235 16:35]:

Very bad points:

Have a look at ruby-doc.org, there should be contact information there.

Cheers
Dick

···

--
'Robots don't have emotions, and that sometimes makes me feel sad.'
    -- Bender
Rasputin :: Jack of All Trades - Master of Nuns

ruby-doc.org is managed by James Britt (that would be me), though I am
hardly the creator of all the really useful content.

Could you be more specific about what "Poor documentation and
questionable reliability of basic tools" means? Poor documentation for
the core language, or certain tools (such as irb)? Or something else?

Concerns over docs for FreeRIDE are best directed to the FreeRIDE
development team.

jbritt AT ruby-doc DOT org is best for direct ruby-doc.org comments,
though public discussion of documentation issues is a Good Thing. But
if you or anyone else has docs or help files they wish to contribute,
get in touch and I'll see that they get to the right place.

Thanks,

James Britt

···

On Fri, 25 Feb 2005 02:36:53 +0900, Dick Davies <rasputnik@hellooperator.net> wrote:

* JC <umptious@gmail.com> [0235 16:35]:
> Very bad points:

Have a look at ruby-doc.org, there should be contact information there.