Re: Examples of Minimalist Writing

Subject: Re: Examples of Minimalist Writing
From: Mike Starr <mike -at- writestarr -dot- com>
To: 'techwr-l List' <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sat, 03 Oct 2009 05:03:58 -0500

I did choose the topic of my example just because I knew the dialog box contained a number of sophisticated controls that (in my opinion) need to be fully explained in the documentation.

However, thinking about it a little bit, yes, there is a good reason that this might be a primary task. If I want to output .GIF files, they're limited to a maximum of 256 colors. If I just do a "Save as" and choose .GIF, the program uses its defaults to reduce the color depth of the image to 256 colors, a process that may yield unpleasant results. That's the reason the dialog box exists... to allow the user to control the downsampling used, thus yielding more acceptable results.

Mike Starr WriteStarr Information Services
Technical Writer - Online Help Developer - Technical Illustrator
Graphic Designer - Desktop Publisher - MS Office Expert
(262) 694-1028 - mike -at- writestarr -dot- com -

Milan Davidovic wrote:
> On Thu, Oct 1, 2009 at 12:32 PM, Leonard C. Porrello
> <Leonard -dot- Porrello -at- soleratec -dot- com> wrote:
>> A Minimalist approach doesn't preclude reference
>> documentation. It precludes giving step-by-step directions covering how
>> to do things that users already know how to do or can easily figure out.
> Do think that task analysis that's true to the minimalist ][aradigm
> would produce topics such as "How to decrease the color depth of an
> image to 256 colors"? My impression has been that minimalism is more
> focused on user goals such as "reducing the file size" or some such.

Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Re: Examples of Minimalist Writing: From: Mike Starr
RE: Examples of Minimalist Writing: From: Leonard C. Porrello
Re: Examples of Minimalist Writing: From: Milan Davidovic

Previous by Author: RE: Examples of Minimalist Writing
Next by Author: Re: Examples of Minimalist Writing
Previous by Thread: RE: Examples of Minimalist Writing
Next by Thread: Re: Examples of Minimalist Writing

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

Sponsored Ads