[OpenIndiana-discuss] Manpages and documentation -- where to start?
tim.e.valentine at gmail.com
Thu Sep 30 12:03:43 UTC 2010
---Quote ---Lastly (for now, of course), how do we want to organise how-tos
and FAQs? On the main OI wiki, or on another wiki/site that enables user
comments or a forum, or one that enables some "Indypedia" type features?"
I believe a forum should be up and running soon as possible. It has been
my experience that this platform is the fastest way to get user questions
answered and to share information with peers. Provided a few good monitors
are available so that one is always, or most always, minding the forum.
I am not a programmer, so I would be glad to help out with documentation,
FAQ and the like if there is anything I can do.
On Thu, Sep 30, 2010 at 2:08 AM, Kevin J. Woolley <kjw at javabunny.net> wrote:
> Hello folks,
> From IRC traffic I understand (perhaps wrongly) that the most up-to-date
> manual pages and documentation aren't available to us due to licensing
> issues. If that's the case I'd like to start putting some effort into
> bringing things up to date. I've got a few questions on how best to do that
> -- if the best answer is "RTFM", then say so, and I will. I'm hoping a few
> good questions now can save some hours of Googling.
> First, where is the current non-manpage documentation maintained, and what
> is the best way to submit changes?
> Second, what are some areas where the most attention is needed?
> Third, what is the best process for updating manpages? I'm assuming
> they're maintained as part of the consolidations they document. Should I be
> asking for commit bits to those, or should we have a process for passing
> them to those who do? Should we even have a uniform process for this, or is
> it too early in the game?
> Lastly (for now, of course), how do we want to organise how-tos and FAQs?
> On the main OI wiki, or on another wiki/site that enables user comments or
> a forum, or one that enables some "Indypedia" type features?
> OpenIndiana-discuss mailing list
> OpenIndiana-discuss at openindiana.org
Be who you are and say what you feel, because those who mind don't matter
and those who matter don't mind.
- Author Unknown
More information about the OpenIndiana-discuss