Re: [fetchmail-devel] FAQ re-write

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

On 8/22/07, Matthias Andree <mat...@gm...> wrote:
>
> Your help will be very welcome.
>
> a. the split is a good idea, although I'm not sure about the "everything
> else" part and if I'd split 3) and 4) - these are often intertwined, and
> we'd have to make sure 6) doesn't contain parts that belong into 3 or 4.

As long as it's pointers I think that's ok.  I'm trying to think of
how people approach the "it's broken" thought process.

As for "everything else", I ran out of thoughts then :)

> b. Berlios have a Wiki, but I'm a bit concerned about the packaging process
> - I can't seem to find an export static pages version, but haven't got the
> time now to check the site documentation for BerliOS.

If it's accessible to the general public I'll have a look later
tonight (I should have an hour or so of time to myself :>).

> Generally speaking, any Wiki we use must be able to export the whole set of
> pages as static documents with working links and with marginal to zero
> effort - I want to ship the FAQ with the fetchmail package; pointing users
> to online sites for documentation is not something I'm eager to do - sooner
> or later someone will be trying to read that info while Berlios has some
> sort of downtime... oops. Can pbwiki.com export HTML and PDF?

I've no idea, but I'll have a look.  I do agree that making
assumptions about the future presence of a web site isn't good.

> In the hope of further discussion on the "how"

And, once the dust settles on this, I'd like to discuss the "how" of
re-working the small novel that is the man page.  That too I feel
needs a split and re-write - every other man page has the command line
options fairly close to the start, not a few dozen screens in.

-- 
                 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