[aklug] Re: Documentation

<ramble>
Ahhhh, documentation.... I've spent some time developing
documentation for open software, and unfortunately often those most
insistent are those least willing to spend a newton to look, read,
reflect. In sum I would have to argue that community documentation is
all too often so far behind the curve fir so many reasons that it is
not cost effective; thankfully there are those who nevertheless impale
themselves on such ventures ;)

On the practical side though I have been looking at OO extensions and
there are a number that I have been playing with for different
purposes (E-scape and eTOK for example)

But, I still think the wiki is the best choice for documentation if
you have an active community with thick skins (nothing I hate more
than inaccurate info-common example is managing php.ini files), though
it would be nice to have a robust wiki extension for exporting to OO
(that is still developing) so that docs created and maintained in wiki
can be easily offered up (and automagically updated) in other formats.
</ramble>

On Sep 15, 2009, at 9:47 AM, "Shane R. Spencer" <shane@bogomip.com>
wrote:

> I've been meaning to populate madmanguides.com with documentation.
> It's
> a good idea. Initially I wanted to create a sane method of writing
> docbook or deriving docbook from asciidoc/rst/textile/etc for groups.
> I've looked for products that help with it (other than google docs)
> and
> I'm not all that impressed.
>
> For fun and profit, check out gobby at some point.. It's an
> interesting
> server based approach to collaborative text editing.
>
> - Shane
>
>
> damien@linuxninjas.tv wrote:
>> I know people hate doing documentation. However, I think AKLUG
>> needs some linux documentation. I have been at Friday night lab
>> sessions where Linux installations have taken a lot longer then
>> they should.
>>
>> If someone asks about multimedia support for one of the top
>> distributions, we should have an answer. A step by step guide. I
>> think it should take no more then 5 minutes, not including download
>> time. That means no more searching google for the answer.
>>
>> Just a suggestion.
>>
>>
>>
>>
>> Sent via BlackBerry by AT&T
>> ---------
>> To unsubscribe, send email to <aklug-request@aklug.org>
>> with 'unsubscribe' in the message body.
>>
>>
>
> ---------
> To unsubscribe, send email to <aklug-request@aklug.org>
> with 'unsubscribe' in the message body.
>
---------
To unsubscribe, send email to <aklug-request@aklug.org>
with 'unsubscribe' in the message body.
Received on Tue Sep 15 12:04:24 2009