From: Douglas Livingstone Date: 2005-01-22T00:22:21+09:00 Subject: Re: Best ways to accelerate Ruby's popularity On Fri, 21 Jan 2005 23:38:50 +0900, James Edward Gray II wrote: > > I feel we should definitely keep a separation of Third-Party APIs and > Core/Standard Library Ruby Docs. Those libraries do not ship with Ruby > and thus the documentation should not be mixed in with libraries that > do, where it could cause a lot of confusion. It would be sensless to have documentation without making it clear what is being documented. Looking at the box again: Third-party API Docs Rimport Tool for importing new data files into ri, using RDoc XML oputput. Now on RubyForge! REXML Pure-Ruby XML parser The first isn't a link to documentation, infact it is the same link as the "Rimport" link in the "Tools" section. Either link to the documentation (I'm not sure that's terribly useful, is the aim or ruby-doc to collect all documentation about things written in Ruby, or is it about Ruby itself + documentation on making documentation?) or don't. For REXML, isn't that included in the main distribution now? If so, is it still a 3rd party API? If those two links dissapear... there isn't a "Third-party API Docs" section anymore :) There may be some merit in having a source for *all* the documentation, but it would probably be a massive workload to organise, and if I was looking for documentation I would go and look for it where I got the thing I'm looking for documentation for, if you see what I mean :) Cheers, Douglas BTW: the link to the UK FTP mirror on the ruby-lang downloads page looks dead: ftp://ftp.mirror.ac.uk/sites/helium.ruby-lang.org/ruby/ on http://www.ruby-lang.org/en/20020102.html Same with the HTTP link: http://www.mirror.ac.uk/sites/helium.ruby-lang.org/ruby/ # United States 3 (binarycode.org) gives an empty "Index of /ruby" directory # United States 4 (online-mirror.org) is "not found" Belgium (Easynet) links back to the ruby-lang site, advertising a download for 1.6.8 and "The first preview of 1.8.0". Probably doesn't belong in the mirrors list. The "# United States 1 (lcs.mit.edu)" FTP mirror complains that I'm on the wrong continent, which is OK I guess.