[Mailman-Users] Mailman documentation

[Bill Horne]

Subject:         Re: [Mailman-Users] TFM & black hole syndrome
Date:             Tue, 16 Oct 2001 14:30:57 -0700

Amanda <arandall at auntminnie.com> said:

>Well, and then there's the fact that TFM is, generally speaking:
fragmented,
>incoherent, written from the developer's perspective (rather than the
>administrator's), not entirely up-to-date, not comprehensive, rarely up
to
>technical writing standards, and not always even in standardized
English
>(American or British, I care not which).

[snip]
>I must tell you, my first experience with Linux software documentation
gave me a
>migraine. It wasn't worth the energy used to display the FM on the
screen. I
>understood less after reading it than before. My allergy to this
bizarre and
>unhelpful genre of "writing" is not getting much better with the
passage of time.
[snip]
>I've long been tempted to hand one of these
>products to a group of ten-year-olds and have then write the tech
manual for it,
>because their writing is, on average, more insightful, logical, and
easy to
>follow.

>Having vented that little bit of spleen, I have to say that the Mailman
docs are
>less offensive than most. :-)
[snip]

Amanda,

The Linux Documentation Project (http://www.linuxdoc.org) needs your
help. Please become part of the solution.

Bill

--
Bill Horne