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.
* User-friendly documentation is documentation in
which the number of skips and jump-to's that the
end-user must perform in reading the documentation is
minimized.
* The way to minimize skips and jump-to's is with
good modular design.
The two page layout thing is not nearly as important.
What Weiss would not say - but I am not afraid to - is
that good modular design depends upon good modular
analysis - data flow diagrams.
Tony Markos
--- "Susan W. Gallagher" <sgallagher5 -at- cox -dot- net> wrote:
>
> > If someone wanted to improve their professional
> knowledge and
> > skills, would people recommend this book?
>
> The book is old -- I read it in 1994 and it was old
> then -- but it is rather
> unique in its advice for paper manuals and I don't
> think the advice has been
> repeated.
>
> It explains how to craft a modular user manual --
> module in this case being
> defined as a technique in which each topic is
> covered in its own two-page
> spread with description here and graphic there and
> procedure in the other
> place and every two-page spread looks exactly the
> same and the information
> is organized identically.
>
> It's an iteresting technique. I wrote a user manual
> that way once ....
__________________________________
Do you Yahoo!?
Yahoo! Mail - Easier than ever with enhanced search. Learn more. http://info.mail.yahoo.com/mail_250
ROBOHELP X5 - SEE THE ALL NEW ROBOHELP X5 IN ACTION!
RoboHelp X5 is a giant leap forward in Help authoring technology, featuring all new Word 2003 support, Content Management, Multi-Author support, PDF and XML support and much more! View an online demo: http://www.macromedia.com/go/techwrldemo
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.
