[oi-dev] Fwd: [OpenIndiana-discuss] Documentation-Project

[ken mays]

Hello,
 
The documentation tools require an ease-of-use functionality for anyone to update without
much learning to use the tool involved.
 
Don't have tools that may complicate the learning and acceptance curve. Many people that can write docs want ease of use and WYSIWYG tools that can convert to man->html->pdf->text formats.
 
Using a tool that is 'not popular and does not meet the mentioned criteria' will get shelved eventually due to limited user acceptance. Even by those willing to learn the tool.
 
~ Ken Mays 
--- On Sun, 6/5/11, Bayard Bell <buffer.g.overflow at googlemail.com> wrote:


From: Bayard Bell <buffer.g.overflow at googlemail.com>
Subject: Re: [oi-dev] Fwd: [OpenIndiana-discuss] Documentation-Project
To: "OpenIndiana Developer mailing list" <oi-dev at openindiana.org>
Date: Sunday, June 5, 2011, 11:33 AM


On 5 Jun 2011, at 16:31, Volker A. Brandt wrote:

>> I think we need tools that then turn into getting people involved in
>> documentation, this is an opportunity where we need to understand how we
>> capitalise on that for further opportunity. You've expressed some interest
>> in contributing to documentation: what would get you to become involved in
>> this capacity?
> 
> While the question was directed at Ken Gunderson, I can answer for
> myself that it's a question of available time.  So the best tools
> would be those that provide easy access, a not-too-steep learning
> curve, and the opportunity to work on things on and off, not having
> to do elaborate setup tasks each time.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://openindiana.org/pipermail/oi-dev/attachments/20110605/73f841ef/attachment-0005.html>