Subject: Re: [Mailman-Users] TFM & black hole syndrome Date: Tue, 16 Oct 2001 14:30:57 -0700
Amanda <[EMAIL PROTECTED]> 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 ------------------------------------------------------ Mailman-Users maillist - [EMAIL PROTECTED] http://mail.python.org/mailman/listinfo/mailman-users