As for the question about the package, absolutely.

As for the language, the ruby community as a whole is working very hard to improve the documentation, and as one can see, it is getting better over the time.