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.
Subject:RE: You're too stupid for this document? From:"Alyssa Fox" <afox -at- zeh -dot- com> To:"Darren Barefoot" <dbarefoot -at- mpsbc -dot- com>, "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Tue, 14 Mar 2000 09:18:39 -0800
We use something along the lines of:
"This guide is intended for System Administrators and Operators who will be
involved in configuring and maintaining Plot Express Manager. This guide
assumes that the person using the software is an experienced UNIX or Windows
NT user and has access to a text editor."
HTH,
Alyssa Fox
-----Original Message-----
From: bounce-techwr-l-26245 -at- lists -dot- raycomm -dot- com
[mailto:bounce-techwr-l-26245 -at- lists -dot- raycomm -dot- com]On Behalf Of Darren
Barefoot
Sent: Monday, March 13, 2000 12:36 PM
To: TECHWR-L
Subject: You're too stupid for this document?
Good afternoon,
We write quite a few technical bulletins, some of each are directed at
system administrators and other advaced users. Does anybody have some
standard boilerplate text that gently and effectively articulates the
intended audience for a document? We currently go with something like this:
"To understand and implement the procedures outlined in this article, you
should have an intermediate to advanced knowledge of MicroBlatt TreeMulcher
2000."
We also tend to set off this sort of information in the left margin of the
first page of the bulletin. Still, I'm finding it somewhat unsatisfactory.
Any tips regarding articulating the intended audience would be much
appreciated. Thanks. DB.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Sponsored by Weisner Associates Inc., Online Information Services
Training & consulting for RoboHELP, Dreamweaver, HTML, and HTML-Based Help.
More info at http://www.weisner.com/train/ or mailto:training -at- weisner -dot- com -dot-
Your web site in 32 languages? Maybe not now, but sooner than you think.
Contact ForeignExchange for the FREE paper, "3 steps to successful
translation management" (http://www.fxtrans.com/3steps.html?tw).
---
You are currently subscribed to techwr-l as: afox -at- zeh -dot- com
To unsubscribe send a blank email to leave-techwr-l-26245G -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.