[Mailman-Users] Mailman documentation
Bill Horne
billhorne at mediaone.net
Wed Oct 17 13:33:42 CEST 2001
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
More information about the Mailman-Users
mailing list