The Majestic Sea Creature
    • Edit
    • Delete
    • Tags
    • Autopost

    Giving the RubyGems documentation some love

    Right now, the RubyGems end user documentation sucks. Here's what we can do to fix it:

    • Unify docs.rubygems.org and guides.rubygems.org. These sites both solve the same problem, and should be combined.
    • Update all guides to use the RubyGems 1.8 API, with notes about changes since 1.3.7 where appropriate
    • Add a new guide about the plugin system and how it's meant to be used.
    • Add a new guide about what to expect when upgrading your RubyGems installation
    • Add an up to date "Frequently Asked Questions" guide
    • Actively accept bug reports, requests, and patches from users to the guides.
    • Do other good stuff that the community would benefit from

    I now have commit access to github.com/rubygems/guides and will be spending some time making the above mentioned improvements. But I can really use your help figuring out where the problems are. Please file tickets or send pull requests, and I'll be sure to look into whatever you send my way. RubyGems can and should be awesome, but it will take the community's support to make it so.

    If you have any questions, please feel free to let me know what's on your mind in the comments section below.

    Tags » rubygems
    • 14 June 2011
    • Views
    • 8 Comments
    • Permalink
  • majestic @seacreature

    Hello, my name is Gregory Brown. I am the founder of Mendicant University, a free online school for software developers.

    I am passionate about community service, education, and the free software movement. If you're interested in getting to know me a bit better, feel free to send me an email: gregory.t.brown@gmail.com

    Archive

    2011 (53)
    August (7)
    July (9)
    June (11)
    May (11)
    April (2)
    March (8)
    February (4)
    January (1)
    2010 (33)
    December (2)
    November (1)
    October (3)
    September (13)
    July (3)
    June (10)
    April (1)
    2009 (1)
    May (1)
    2008 (62)
    October (2)
    September (1)
    August (3)
    July (2)
    June (3)
    May (3)
    April (14)
    March (11)
    February (11)
    January (12)
    2007 (61)
    December (4)
    November (2)
    October (5)
    September (4)
    August (2)
    July (10)
    June (15)
    May (19)