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'm editing/rewriting 2 documents for a financial
planning application. think of it as a spreadsheet on
steroids.
The first document is called Getting Started. It's a
quick start guide, really - a high-level overview of
the main features of the software and how to use them.
It walks through the creation of a very simple model.
The second document is called the Application Guide.
It covers 2 kinds of information. The first section
is contains detailed instructions (but it's definitely
not a procedure manual)on how to set up the model and
the different ways you can view the information,
including developing and printing reports.
I'm not sure "Application Guide" is the right title
for this kind of document - any suggestions?
The second kind of information is what's *really*
giving us a headache. Along whith the actual program,
users get some sample models (one of which is the one
created in the Application Guide) -- the second set of
information is a review of the models themselves --
not how they were created, but a description of the
example models: variables, calculation rules, and so
on.
Users can use these models as templates to create
their own applications specific to their situation.
Two questions: 1) should the two types of information
be in the same document,or should they be in separate
ones?
2) What would you call the section or document that
contains this second type of information?
many thanks,
Becca
__________________________________________________
Do You Yahoo!?
Talk to your friends online with Yahoo! Messenger. http://im.yahoo.com