In message “Re: Ruby 1.9.0 is released”
on Wed, 26 Dec 2007 13:08:21 +0900, “Jeremy McAnally” [email protected] 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 [email protected] 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.
[email protected] 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.
In message “Re: Ruby 1.9.0 is released”
on Thu, 27 Dec 2007 02:52:17 +0900, Charles Oliver N. [email protected] writes:
|> How about updating doc/NEWS file, and sending patches to
|> [email protected] 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.
That would be great, Charles. I’m looking over what’s there now and
hopefully I can start contributing after the holidays.
Thanks!
Jeremy
On Dec 27, 2007 10:29 AM, Charles Oliver N. [email protected]
wrote:
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.
In message “Re: Ruby 1.9.0 is released”
on Thu, 27 Dec 2007 02:52:17 +0900, Charles Oliver N. [email protected] writes:
|> How about updating doc/NEWS file, and sending patches to
|> [email protected] 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…
