Such a small portion of gems use RDoc that it hasn't been a big
issue, but I would love to get it fixed. I think in most cases
making a separate docs site is preferable to putting a ton of info
in your gem's description.
6 Posted by Lawrence Woodman on 22 Apr, 2011 05:42 AM
That makes more sense now, as it did seem to be trying to do
something with RDoc.
I take your point about shorter descriptions being more useful.
I'm new to Ruby and was trying to emulate the other projects that
I'd been looking at to fit in to the Ruby way. It was a little
unfortunate that the ones that caught my eye, read their full
README file into the description, though admittedly they
were not using RDoc.