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.
John Posada wrote:
> Bonnie...not to be a stickler and I'm not looking to ding your work
> (god knows I might not stand up to examination), but this is the
type
> of issue I believe we should strive to avoid.
>
That text is part of guidelines for configuring Windows NT Server.
Artisoft determined that the text was suitable for the audience for
this manual. The audience for this manual is network administrators or
others who have understanding of the issues involved.
> "...installed on the Server, you can choose
> Yes or No for DHCP depending on how
> your network is configured."
>
> "Deselect the IPX/SPX checkbox unless
> your network needs it."
>
> At this point, I might be wondering "How IS my network configured or
> how do I know if I need it?"
>
You wouldn't be reading this manual if you didn't know what was
necessary for installing software of this type and your network
requirements.
> I once referred to personas. At my last job, I created one called
> "Igor". Igor was a third-shift NOC operator who's been on the job
for
> one week and needs to be walked though the process of fixing a
network
> outage. These are the issues that might stump him.
>
> OTOH, you might not be writing for him.
>
Exactly. The content of this manual indicates the audience for which
it is suitable.
SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more! http://www.macromedia.com/go/techwrldemo
>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more. http://www.doctohelp.com
---
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- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
