Re: [fetchmail-devel] FAQ re-write

[Rob M. <rob...@gm...>]

On 8/23/07, Matthias Andree <mat...@gm...> wrote:
> On Wed, 22 Aug 2007, Rob MacGregor wrote:
<---SNIP--->
> Well, the MoinMoin wiki engine has a command-line tool to export static
> HTML pages, Timo Sirainen is using that for snapshotting the Dovecot
> Wiki contents. (Dovecot is a fast combined IMAP/POP3+SSL server
> supporting mbox and Maildir, among other useful features.)

That would certainly make life easier.

> If the Wiki can't export to HTML, perhaps we can stick to using a set
> of HTML pages - it's easier to control quality that way, too: we don't
> need to eyeball it constantly to avoid other people posting stupid
> things (such as enclosing mda placeholders in single quotes, injecting
> into sendmail with variable destination address or something).
> I'm not at all against the concept of a Wiki, but I think some kind of
> "peer review" to avoid stupidities should be inherent once we deal with
> security sensitive stuff.

If we go the wiki route then it would have to support (at least) 2
levels of users - admins (those you trust not to stuff up the
documentation) and everybody else (who have read only access).

Looking at the MoinMoin wiki documentation it does support that, plus
email notifications about page edits.

As for peer review, presumably such discussions could take place via
email, or even via Talk pages in the wiki?

> The HTML document is in SVN, and I think we (that means my asking Graham
> Wilson) can arrange commit access for you, or we can just revive the
> BerliOS SVN stuff to host the web site.

Well, getting up and running with SVN wouldn't be terribly difficult,
so that's always an option.

I'll admit that I'm looking for a solution that involves the minimal
amount of effort post-edit - I'm lazy but at least I know it ;)

-- 
                 Please keep list traffic on the list.

Rob MacGregor
      Whoever fights monsters should see to it that in the process he
        doesn't become a monster.                  Friedrich Nietzsche