On 1/18/07, Hugh Sasse <[EMAIL PROTECTED]> wrote: > On Thu, 18 Jan 2007, Chad Fowler wrote: > > > On 1/18/07, TRANS <[EMAIL PROTECTED]> wrote: > > > On 1/18/07, Chad Fowler <[EMAIL PROTECTED]> wrote: > > > > > > > Sounds like a pretty serious edge case to me. RDoc isn't something > > > > you generally make a link to. It's something that lives inside your > > > > source and is generated. For all but the rare edge case, I think this > > > > would go unused. > > > > > > Then there has to be a way to dictate proper generation doesn't there? > > > It's going awefully far to designate something an "edge case" b/c it > > > doesn't conform to RDoc documentation. What if someone wants to use a > > > different doc system... What if someone writes a program in such a way > > > that RDoc can't even handle it well --that's rather easy actually. > > > > > > > What if someone wanted to not use Ruby at all? > > :-) Should I hold your coat? :-) > > There is a way to declare what rdoc options to use, which would > determine better generation, but it might be possible to tell it > to use something other than rdoc, and use the options for that. > Or the rdoc options could he kept for if/when rdoc is used, and > since this is YAML one could have an array of alternative doc systems > and a corresponding array of of options. Or maybe a hash. > I'm not sure that one can assert YAGNI in this case: we live in a > world with LaTeX, Lout and DocBook. >
I guess I disagree. We can assert YAGNI for RubyGems doc generation. If someone wants to do LaTex, that's fine. They can create another mechanism with which to do it. I don't think we have to extend RubyGems to allow for (or even encourage) divergent documentation systems. We certainly don't prevent them. > On the gems homepage should there not be a link to Gemtacular, now > that it has been blessed (erm, not in the Perl sense...)? > Yea. It will become the RubyGems.org home page soon. Chad _______________________________________________ Rubygems-developers mailing list Rubygems-developers@rubyforge.org http://rubyforge.org/mailman/listinfo/rubygems-developers
