Ugly rdoc parsing on gem page

Lawrence Woodman's Avatar

Lawrence Woodman

12 Apr, 2011 11:59 AM

I have uploaded a gem and found that the README.rdoc file has been automatically presented on the RubyGems page for that gem. However, the formatting is all off, has anyone any ideas as to how to get around this?

The gem is: Mida

  1. 1 Posted by Luis Lavena on 12 Apr, 2011 12:07 PM

    Luis Lavena's Avatar

    You should not be using RDoc as the gem specification description or
    summary fields.

    These are not intended to be formatted in the website, Plain text is
    the way to go.

  2. 2 Posted by Lawrence Woodma... on 12 Apr, 2011 12:12 PM

    Lawrence Woodman's Avatar

    Thanks Luis, I'll make the needed changes. It is strange though that RubyGems tries to parse the file, as it has marked up some of the text.

  3. Support Staff 3 Posted by Nick Quaranto on 21 Apr, 2011 01:59 PM

    Nick Quaranto's Avatar

    We've known about this for a while:

    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.

  4. Support Staff 4 Posted by Nick Quaranto on 21 Apr, 2011 02:00 PM

    Nick Quaranto's Avatar

    Also, will show your README, as will GitHub. Don't put your whole README into the gemspec. :/

  5. 5 Posted by Lawrence Woodma... on 22 Apr, 2011 05:42 AM

    Lawrence Woodman's Avatar


    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.

  6. 6 Posted by Luis Lavena on 23 May, 2011 09:35 PM

    Luis Lavena's Avatar

    Hello Lawrence.

    Seems all is sorted out on this issue, so I'm going to close it out.

    If you want you can help Nick on the GitHub issue ;-)


  7. Luis Lavena closed this discussion on 23 May, 2011 09:35 PM.

Comments are currently closed for this discussion. You can start a new one.

Keyboard shortcuts


? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac