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.