From: Eric Hodel <drbrain@...7.net>
Date: 2007-11-28T13:46:22+09:00
Subject: Re: Creating a rubygem - a story and help request

On Nov 26, 2007, at 07:53 AM, Jeremy McAnally wrote:
> On Nov 26, 2007 9:30 AM, Phrogz <phrogz@mac.com> wrote:
>> On Nov 25, 10:01 pm, 7stud -- <bbxx789_0...@yahoo.com> wrote:
>>> Gavin Kistner wrote:
>>>> The Request
>>>> Help! How do I create a gem? I know that once I do, and upload it  
>>>> to
>>>> rubyforge, that it will magically be available to all. But first I
>>>> need to create one, and...I'm stumped.
>>>
>>> pickaxe2, Chapter 17 has a section titled: Creating Your Own  
>>> Gems.  I
>>> haven't read it yet, so I don't know how helpful it is.  It's 10  
>>> pages
>>> long.
>>
>> So it does. I'll read through that, but I maintain that Rubygems
>> should not rely on a 3rd party must-buy book to document what ought  
>> to
>> be described on their website.
>
> Welcome to the apparent nature of learning important Ruby libs. :)
>
> Take a look around for some solid docs on Rails.  You probably won't
> find anything outside of the RDocs, which aren't sufficient in a lot
> of cases.  Though these kinds of docs are being worked on for Rails, I
> think that's just the nature of the beast for other libs until someone
> takes it upon themselves to create something.
>
> I didn't realize RubyGems lacked something like that; it may be worth
> creating at least a quick reference...

I could easily throw a quickref under `gem help` somewhere.