Hello!

I just got started with Ruby after years of Java and I'm having a lot
of fun with it! Especially with the pragmatic programmer's book by my
side.

There's one thing that reduces the fun I have: the way Ruby libraries
are documented. Even the documentation of the standard and the core
APIs are below par if you ask me. That's one thing the Ruby community
can learn from the Java community: how to do proper documentation.
Additional Java APIs are easy to find and the API docs always look the
same, which makes it very easy to get started with a new API. In Ruby
new APIs are harder to find and it's always the question if there is
any documentation and what it will look like.

Kind regards,
CyBerco