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: Code Annotation of the Week From:"Gene Kim-Eng" <techwr -at- genek -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 11 Nov 2009 11:37:43 -0800
Progammers and programmers' supervisors are almost never the "go to" people for
decisions about what is customer-suitable; you go to those people for answers
about what is technically accurate. Product/customer "command decisions" should
come from product/marketing managers, and unless you're working in a small
startup where these people don't exist or a giant comglomerate with a silo-type
organization that is run like the DoD and the managers get all huffy when
approached by someone who isn't also a manager these people need to be included
in the writers' contacts from the earliest document planning stage.
Gene Kim-Eng
----- Original Message -----
From: "Robert Lauriston" <robert -at- lauriston -dot- com>
> Sure, generally, but in this case the writer had already gone to the
> programmer and the programmer's immediate supervisor. As a docs
> manager, unless the writer had a peer relationship with the next
> person up the line, I'd want them to check with me first.
Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at: http://www.doctohelp.com/
Help and Manual 5: The all-in-one help authoring tool. Full support for
team authoring with multi-user editing - both directly and in combination
with VSS-compatible source control systems. http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-