Re: Docs To Do list and other ideas. Please contribute

[Marc Patermann <hans.moser@ofd-z.niedersachsen.de>]

Hi,

Michael Ströder schrieb (05.07.2012 21:57 Uhr):
> Gavin Henry wrote:
> > On 5 July 2012 16:44, Gavin Henry <gavin.henry@gmail.com> wrote:
> > > On 5 July 2012 08:23, Michael Ströder <michael@stroeder.com>
> > > wrote:
> > > > xsun wrote:
> > > > > I don't remember if we talked about a wiki in the past but
> > > > > it's definitely a good idea.
> > > > While Wikis seem to be attractive at first glance the biggest
> > > > caveat is that you can't cut a doc release of all the pages for
> > > > a certain software release.
> > > >
> > > > In other open source projects which have all the docs in a Wiki
> > > > this turned out to be a major issue.
> > Good point. We would just need to decide what docs go in the Wiki
> > and what format we export them as for the guide.
>
> To add more:
>
> 1. It's IMO better to commit doc changes along with code changes if
> possible. I think this is already done with man pages. That's almost
> impossible with wiki pages. 
> [...]
> 4. Editing wiki pages cannot be done while being off-line during
> travel...
Gavin already mentioned dokuwiki. And I think point 1. and 4. could
be done by using dokuwiki with its plain text backend.
http://www.dokuwiki.org/dokuwiki


Marc