In message “Re: Ruby 1.9.0 is released”
on Wed, 26 Dec 2007 13:08:21 +0900, “Jeremy McAnally” removed_email_address@domain.invalid writes:
|
|Could you point out some areas that are in dire need of documentation?
| I’ve been wanting to get involved with Ruby core documentation but
|haven’t had a discrete task list to concentrate on.
How about updating doc/NEWS file, and sending patches to removed_email_address@domain.invalid list? Or we can set up Wiki pages for
cooperate documentation writing.
I don’t think ubuntu updates to new versions of software after the
initial release unless it’s a bugfix release. I think Nei Kai would
have to compile Ruby 1.9.0 to get it.
What about spec.ruby-doc.org? It’s already got a lot of documentation
for various aspects of 1.8, and I’d be ecstatic if it could be used as a
cooperative place to document Ruby 1.9 as well.
|> How about updating doc/NEWS file, and sending patches to
|> removed_email_address@domain.invalid list? Or we can set up Wiki pages for
|> cooperate documentation writing.
|
|What about spec.ruby-doc.org? It’s already got a lot of documentation
|for various aspects of 1.8, and I’d be ecstatic if it could be used as a
|cooperative place to document Ruby 1.9 as well.
It’s a great place if they accept 1.9 changes in spec.
That would be fantastic. Perhaps we could branch the 1.8 spec and 1.9
spec so the work can continue on both?
We could easily provide a 1.8 and 1.9 entry point, and they could
cross-link whereever necessary. It would simply be a matter of adding
some links to the front-page as it exists now and possibly splitting
some existing articles into 1.8 and 1.9-compatible versions.
I can make this change any time (and of course, so can all of
you)…shall I?
I control the wiki’s hosting at the moment, so I could also set it up
for multiple languages, if it would make it easier to get documentation
up to have separate Japanese/English pages.
I control the wiki’s hosting at the moment, so I could also set it up
for multiple languages, if it would make it easier to get documentation
up to have separate Japanese/English pages.
In message “Re: Ruby 1.9.0 is released”
on Thu, 27 Dec 2007 02:52:17 +0900, Charles Oliver N. removed_email_address@domain.invalid writes:
|> How about updating doc/NEWS file, and sending patches to
|> removed_email_address@domain.invalid list? Or we can set up Wiki pages for
|> cooperate documentation writing.
|What about spec.ruby-doc.org? It’s already got a lot of documentation
|for various aspects of 1.8, and I’d be ecstatic if it could be used as a
|cooperative place to document Ruby 1.9 as well.
It’s a great place if they accept 1.9 changes in spec.
note, there is also noobkit.com. It’s being actively nurtured by AlexG
(I know since i’ve been tracking/using it…). An example is http://www.noobkit.com/show/ruby/ruby/ruby-core.html. Friendly
interface, full search, and w active links/reference… My point is, if
people can find things easily, then it would be easy to document…
