<table cellspacing="0" cellpadding="0" border="0" ><tr><td valign="top" style="font: inherit;"><DIV>Hello,</DIV>
<DIV> </DIV>
<DIV>The documentation tools require an ease-of-use functionality for anyone to update without</DIV>
<DIV>much learning to use the tool involved.</DIV>
<DIV> </DIV>
<DIV>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.</DIV>
<DIV> </DIV>
<DIV>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.</DIV>
<DIV> </DIV>
<DIV>~ Ken Mays <BR>--- On <B>Sun, 6/5/11, Bayard Bell <I><buffer.g.overflow@googlemail.com></I></B> wrote:<BR></DIV>
<BLOCKQUOTE style="BORDER-LEFT: rgb(16,16,255) 2px solid; PADDING-LEFT: 5px; MARGIN-LEFT: 5px"><BR>From: Bayard Bell <buffer.g.overflow@googlemail.com><BR>Subject: Re: [oi-dev] Fwd: [OpenIndiana-discuss] Documentation-Project<BR>To: "OpenIndiana Developer mailing list" <oi-dev@openindiana.org><BR>Date: Sunday, June 5, 2011, 11:33 AM<BR><BR>
<DIV class=plainMail>On 5 Jun 2011, at 16:31, Volker A. Brandt wrote:<BR><BR>>> I think we need tools that then turn into getting people involved in<BR>>> documentation, this is an opportunity where we need to understand how we<BR>>> capitalise on that for further opportunity. You've expressed some interest<BR>>> in contributing to documentation: what would get you to become involved in<BR>>> this capacity?<BR>> <BR>> While the question was directed at Ken Gunderson, I can answer for<BR>> myself that it's a question of available time.  So the best tools<BR>> would be those that provide easy access, a not-too-steep learning<BR>> curve, and the opportunity to work on things on and off, not having<BR>> to do elaborate setup tasks each time.<BR><BR></DIV></BLOCKQUOTE></td></tr></table>