From: botp <botpena@...>
Date: 2010-06-04T22:22:10+09:00
Subject: Re: Documenting Ruby 1.9: Ebook or Wiki?

On Fri, Jun 4, 2010 at 8:57 PM, Robert Klemme
<shortcutter@googlemail.com> wrote:
> 2010/6/4 Run Paint Run Run <runrun@runpaint.org>:
>> In the absence of a consensus, I suppose I'll keep to this kind of
>> format ( http://ruby.runpaint.org/methods ) for now. Maybe if interest
>> picks up subsequently, I'll look at making the chapters editable
>> similar to what Mohit suggested.
>
> Thanks for your effort!  Since you said you are writing a book I
> assume you have particular kinds of readers in mind and will give it a
> flow so it can be reasonably read from start to end.  I don't think a
> Wiki is a good container for something like that.  If you want to
> allow for user added content then it's probably best to have some kind
> of commenting functionality (as they do for PostgreSQL documentation,
> see http://www.postgresql.org/docs/).
>

i think you can  add comment feature in wikis.
btw, it would be also nice to include a ruby-format (besides plain
markdown/textile) so as to allow nice/uniformed ruby code formatting
...

kind regards -botp