Re: Minimalism

Subject: Re: Minimalism
From: John Ahlstrom <jahlstro -at- CISCO -dot- COM>
Date: Thu, 9 Jan 1997 16:33:57 -0800

Robert Plamondon wrote:


> Watch out for the two schools of minimalism floating around: the real
> school and the fake one.
>
> The fake school of minimalism just cuts the documentation to some
> arbitrary length. One can always cut one's documentation 90% by
> simply dropping 90% of the material on the floor and leaving the
> readers in the lurch.
>
> The real school of minimalism does more with less. Express the basic
> concepts clearly, itemize all the building blocks, give a couple of
> examples of how they can be put together, and stop.
-- snip snip

Let us all remember what Pascal said at the bottom of a
letter to a friend:
I am sorry this is so long, I did not have time
to make it shorter.


JKA

A conclusion is simply the place where you got
tired of thinking.
Anon.

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: Help Desk Doc Question
Next by Author: Re: Should Techwhirlers Program?
Previous by Thread: Re: Minimalism
Next by Thread: Re: Minimalism


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads