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.
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
--
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 - http://www.writestarr.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. http://www.doctohelp.com/SuperPages/Webcasts/
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! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-