TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: What exactly is minimalist documentation? From:Carma C Allen <ccallen -at- BECKMAN -dot- COM> Date:Mon, 27 Oct 1997 15:12:42 -0800
The following was offered in response to a question about the definition
and purpose of minimalist documentation:
>Applied to software documentation, the goal of minimalist documentation is
>provide just enough information that the user is able to find out just
>crucial information to get by with basic tasks. Enough information is
>provided to allow the user to figure out non-basic tasks on their own. By
>figuring things out on their own, the user learns how to use the software
>better, and has greater retention. In other words, the goal is not to just
>have fewer words, or kill fewer trees, but to enhance usability by
>a minimal safety net over which a user can explore and learn.
Oh, please!! This sounds like my bank telling me that "to serve me
better," it's closing every branch office within miles of my home or
The purpose of minimalist documentation is to save money and increase
profits. That's not necessarily a bad thing, but let's be frank about it.