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:You're too stupid for this document? From:Darren Barefoot <dbarefoot -at- mpsbc -dot- com> To:"Techwriting list (E-mail)" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Mon, 13 Mar 2000 12:36:18 -0800
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.
