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.
Re: On the value of glossaries containing terms the audience should already know
Subject:Re: On the value of glossaries containing terms the audience should already know From:Robert Lauriston <robert -at- lauriston -dot- com> To:"TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Fri, 20 Dec 2013 15:46:40 -0800
Elissa said, "I don't think you have any business mucking around with
*anything* covered in this guide if you don't know what DNS and IP
mean," which might mean she's got a similar audience.
For example, if I were documenting a command-line interface for a
piece of hardware that lives in an equipment closet, such as a big
router or network switch, I would never waste time and space defining
DNS or IP. You don't have a key to the closet if you don't know a lot
more than that. If you're some clueless user dealing with an
emergency, you need to call tech support and have them guide you.
On Fri, Dec 20, 2013 at 2:44 PM, Fred Ridder <docudoc -at- hotmail -dot- com> wrote:
> Robert Lauriston wrote:
>> When you're documenting a mission-critical product that's used only in
>> secure environments with hundreds or thousands of servers, you don't
>> have to worry about that.
>> On Fri, Dec 20, 2013 at 1:29 PM, Gene Kim-Eng <techwr -at- genek -dot- com> wrote:
>> > I've been in more than a few start-ups where some newly hired clerical
>> > employee was handed a network manual and told that he or she was now the
>> > company's sysadmin.
> But that is going to be the case for how many list members? Pronouncements that only apply to one in a hundred members are not very helpful to the other 99. Most of us work in the real world where pointy-haired bosses are all too common.
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.