BT

New Early adopter or innovator? InfoQ has been working on some new features for you. Learn more

Minimalism: Creating Manuals People Can Use

| by Deborah Hartmann Preuss on Jun 19, 2006. Estimated reading time: 1 minute |
Some Agile teams despair when faced with the task of getting technical writers on board with their new, emergent approach. But changes are afoot, and with more widespread application of practices like User Centered Design and single-sourcing, the philosophical gap may not be as wide as is feared. Structured writing, xml standards like DITA and CMS toolsets make it possible to approach documentation differently... although it's equally possible to use these new tools simply to entrench old bad habits.

JoAnn Hackos teaches a minimalistic approach to documentation.  Minimalism isn't only for simple products or targeted at beginners. A minimalist approach makes complex products easier to understand and gets critical information more directly into the hands of experts. She uses a hands-on approach: Students are encouraged to bring real work with them, as they will work on their own documents for more than 50 percent of class time.

People attending her two-day workshop, called Minimalism: Creating Manuals People Can Use, report they've reduced their documentation by 50 to 75 percent. The next session will take place near Philadephia July 11-12, 2006.

Dr. Hackos is the Director of the Center for Information-Development Management (CIDM), a membership organization focused on content-management and information-development best practices, and she has authored numerous books.

This online interview of Dr. Hackos is interesting: like Agile methods, her focus on user-centered design puts the customer first:
User-centered design is focused on the needs of the audience rather than the needs of the organization. It is really important in turning the direction of the web design effort from looking internally in an organization to looking externally and determining the needs of the community you want to influence.

Rate this Article

Adoption Stage
Style

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Tell us what you think

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread
Community comments

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Discuss

Login to InfoQ to interact with what matters most to you.


Recover your password...

Follow

Follow your favorite topics and editors

Quick overview of most important highlights in the industry and on the site.

Like

More signal, less noise

Build your own feed by choosing topics you want to read about and editors you want to hear from.

Notifications

Stay up-to-date

Set up your notifications and dont miss out on content that matters to you

BT