Charles Oliver Nutter wrote:
For those of you who don't know, RubySpec is a MediaWiki-based attempt
of mine to get community members to work together building a Ruby
specification. I figure this is the only real way we're going to get to
a complete spec, and it would additionally provide a comprehensive
online reference for the language itself.
Ruby-Doc does a great job of documenting what the Ruby developers have
been able to document, but it doesn't comprise a spec. Specifically,
deeper details of the language syntax, library implementation, and
platform or impl-specific quirks are largely missed. I'm hoping that
RubySpec can become the clearinghouse for such information.
RubySpec hasn't gotten a lot of attention, but there's a reasonable
start there and a few documents I've never seen published in any English
text or site. Because it seems like an important thing for us to do
(important enough that both matz and _why have made edits) I'd love for
Ruby-Doc to swallow it up. This would probably mean the following:
- I will move RubySpec to the host where jruby's continuous integration
and nightly builds are executing. It's a real hosting provider with all
the trimmings, and they've set up PHP/MySQL for me to make the move
PHP?
:)
(Oh, OK, I see; you need to run MediaWiki.)
- We'd want a better domain...the machine is jruby.thresher.com right
now and just goes straight into Bamboo (our CI server)
- I'd be very pleased if there were prominent links from Ruby-Doc to
appropriate pages in RubySpec as they become available. I think we need
to drive people toward the spec as much as possible, since it's publicly
updateable and should build upon the knowledge we share.
I've added links on the main page, as well as in the common sidebar
(under 'More Ruby-doc') for the site.
Across the middle are sections for the core and Stdlib APIs. In each of
these I added links for the corresponding spec pages
James
|
