From: Robert Klemme <shortcutter@...>
Date: 2010-06-05T06:15:10+09:00
Subject: Re: Documenting Ruby 1.9: Ebook or Wiki?

On 04.06.2010 15:22, botp wrote:
> 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.

Yes, but a Wiki is organized as a hypertext and not as a sequential 
text.  That was my main point.

Cheers

	robert

-- 
remember.guy do |as, often| as.you_can - without end
http://blog.rubybestpractices.com/