Re: Two Techwriting Issues

Subject: Re: Two Techwriting Issues
From: Jane Torpie <Jane_Torpie_at_III-HQ -at- RELAY -dot- PROTEON -dot- COM>
Date: Fri, 17 Dec 1993 13:10:00 EST

Matthew -

These are quick responses; please ask if you'd like more detail.

1. A tutorial works well w/ 2nd person. A user manual is the next step on
a continuum, so that's debatable. A reference guide is yet another step
... by then, I usually prefer 3rd person if possible. Either way, avoid a
lot of "you".

2. For FrameMaker help, I understand (from the Frame Technology people)
that if you want to use the help that Frame generates, it's necessary to
buy their API so your developers can program the right hooks into the
product code.

Jane Torpie
Senior Technical Writer
Easel Corporation
Burlington, MA

Previous by Author: Re[2]: Advice about tech comm depts
Next by Author: Re: A Quandry about Titles...
Previous by Thread: Two Techwriting Issues
Next by Thread: Re: Two Techwriting Issues

What this post helpful? Share it with friends and colleagues:

Sponsored Ads