The problem is that Ruby's documentation, main advocacy sites, and even most sites for popular Ruby libraries (with one major exception - coming later) try

The problem is that Ruby's documentation, main advocacy sites, and even most sites for popular Ruby libraries (with one major exception - coming later) try too hard to demonstrate freedom No, the main problem is that Ruby's documentation sucks. If it tried too hard to demonstrate freedom, it would at least demonstrate normal use cases. I point to http://ruby-doc.org/core/classes/File.html http://ruby-doc.org/core/classes/File.html and I rest my case. I hereby promise to submit a patch for that documentation somewhere next week. It has bothered me for too long.