🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: ca.seminars
Article #1042

Downsizing Your Documentation Seminar

#1042
From: HenryK8
Date: Thu, 18 Aug 1994 22:30
89 lines
4805 bytes
            SEMINARS IN USABLE DESIGN

TITLE:      Downsizing Your Documentation 
DATE:       Monday and Tuesday, Oct 3-4, 1994 
TIME:       8:30 - 4:30 
AUDIENCE:   Managers, technical writers, communicators, marketing
            folks,engineers. 

You've heard about minimalist documentation, but is it appropriate for
your situation and how do you produce it? Downsizing your online and
printed documentation can increase user satisfaction while lowering the
costs of production, maintenance, and distribution. In this workshop,
you will learn how to design lean documentation and scale down your
existing documentation so that you can increase its usefulness without
compromising its completeness. Many seminar graduates have reduced
document size by 50-75%.

_____________________________________________________ 
UNIQUE BENEFITS
You will learn how to: 
*Make documents better by making them briefer.
*Create lean documents with little or no repetition. 
*Shrink existing documents by editing, cutting, and restructuring them. 
*Use images to replace text.
*Decide when and how to replace "how it works" with "how to work it."
*Accurately target information to your audience.
*Eliminate documentation by building information into the product. 
*Make suggestions that get listened to for improving the design of the
 product. 
_____________________________________________________ 
TOPICS TO BE COVERED 

WHY DOCUMENT ANYTHING? 
Why people don't use manuals. Better=smaller. Delivering information via
the product. Delivering information as a service. Zero-based
documentation. 

AIMING FOR USABILITY, NOT COMPREHENSIVENESS 
Letting the product explain itself. Quick reference cards as model
documents. Avoiding the information treasure hunt. Cutting obstructive
overviews. Minimizing passive reading. Replacing overwhelming detail
with hints. Replacing text with art. Turning text into callouts. Cutting
redundant illustrations.

GETTING LEARNERS INVOLVED
Brief procedures for basic tasks. Turning narratives into compact,
effective instructions. Making documents tool, not containers of
informtion. Encouraging exploration. Attuning learners to feedback from
the system.

DECIDING WHAT INFORMATION IS RELEVANT TO USERS
Focusing on meaning and competence. How much information do people want?
What kind? Choosing the appropriate type of information. How it
works?-or-How to work it? 

TAKING A DIAGNOSTIC STANCE TO RECOGNIZE ERRORS
Reducing documentation by anticipating user mistakes. 5 basic types of
mistake. Eliminating common sources of error. Intructing users in error
recognition and recovery.
_____________________________________________________ 
SPECIAL FEATURES
*Case studies, demonstrations, and exercises that clarify downsizing
 problems and illustrate solutions to them. 
*An extensive workbook, profusely illustrated with good and bad
 examples, step-by-step before and afters. 
*An in-class peer review of your own work to uncover opportunities to
 begin downsizing the moment you get back to your desk. Please bring a
 sample of a past work, work-in-progress, or planned work.
_____________________________________________________ 
INSTRUCTOR Henry
Korman, RA. Henry is a partner in WordPlay Communications, focusing on
making technology accessible to everyone. WordPlay has collaborated with
clients such as Apple, Claris, Hewlett-Packard, Lotus, Stentor,
Teknekron, and Xerox-most recently, helping large and small
businesses to improve their documentation while making cuts of up to
75%. His latest book, with Jonathan Price, is "How to Communicate
Technical Information," published by Benjamin Cummings.
_____________________________________________________ 
COST $585--Fees
include all seminar materials, lunch, and refreshments. Full payment is
required prior to the seminar to confirm class space. 

_____________________________________________________ 
CONTACT 
Seminars in Usable Design 
710 Kipling Street, Suite 400 
Denver, CO 80215 
(303) 234-0123 
Fax: (303) 232-0659
Technical Details
Message-ID: <330ndf$e2m@search01.news.aol.com>
Path: arc1-ca.pugleaf.net!bga.com!news.sprintlink.net!redstone.interpath.net!ddsw1!panix!news.intercon.com!howland.reston.ans.net!europa.eng.gtefsd.com!swiss.ans.net!newstf01.cr1.aol.com!search01.news.aol.com!not-for-mail

Show Full Headers
Complete Article Headers
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 109296,553705898d4b3030,start
X-Google-Attributes: gid109296,public
X-Google-ArrivalTime: 1994-08-18 17:22:17 PST
Path: arc1-ca.pugleaf.net!bga.com!news.sprintlink.net!redstone.interpath.net!ddsw1!panix!news.intercon.com!howland.reston.ans.net!europa.eng.gtefsd.com!swiss.ans.net!newstf01.cr1.aol.com!search01.news.aol.com!not-for-mail
From: henryk8@aol.com (HenryK8)
Newsgroups: ca.seminars
Subject: Downsizing Your Documentation Seminar
Date: 18 Aug 1994 18:30:07 -0400
Organization: America Online, Inc. (1-800-827-6364)
Lines: 89
Sender: news@search01.news.aol.com
Message-ID: <330ndf$e2m@search01.news.aol.com>
NNTP-Posting-Host: search01.news.aol.com