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.
> From: richard -dot- combs -at- Polycom -dot- com
> To: techwr -at- genek -dot- com; catrose15 -at- hotmail -dot- com
> CC: techwr-l -at- lists -dot- techwr-l -dot- com
> Date: Wed, 22 Jun 2011 21:51:20 -0700
> Subject: RE: Creating a template with locked
> Gene Kim-Eng wrote:
> > Is this a situation where the other people:
> > a. are all preparing different documents you want to unify
> > b. each own different sections of the same document or
> > c. are all trying to make changes to the same sections of a document?
> > The technical/tools approach is different for each, but for all a
> > certain
> > amount of top-down direction from upper management is needed to drive
> > home
> > the point that a single point of contact (presumably you) is the final
> > arbiter of style and composition standards for all.
> Gene is absolutely correct. Cat, you've gotten some good suggestions. I think by far the best is comment-enabled PDFs that reviewers can mark up in Reader. But the workflow/tool isn't the fundamental problem.
> You described the fundamental problem when you said:
> > 4) The group I am working with is determined to each have their own
> > way, <snip>
> > I'm at my wits end and open to any suggestions. They are driving me
> > nuts with the constant bickering and how nasty and negative they are
> > about these publications if they don't get what they want. And no
> > matter what I do - they are never happy.
> It's not possible to author a coherent document if half a dozen people (especially bickering, nasty people) all have equal authority to decide what's in it, how its presented, and what the wording should be. Someone has to own the document and have the authority (and cojones) to say, "Thanks for your suggestions. I've made my decision about that. Let's move on." If you don't have that authority, and the backing of management, then you're not a tech writer, you're clerical help.
I do feel like a secretary some days... I guess that would explain it.
This is a long-standing problem, and I'm not the only person who has this problem.
> Yes, subject matter experts can and should be able to reject or correct content based on technical accuracy. But it sounds like the group you're working with is going beyond that. (If not -- if this bickering is over substantive issues of accuracy, not wording, manner of presentation, etc. -- then you need to step away, tell the disagreeing -- and disagreeable -- SMEs to resolve the content accuracy issues among themselves and then get back to you.)
It's legal information. It's not information we can change the wording on because if/when we get taken to court about it - our lawyers would have no room to stand if that language was not consistent to what is in our legal document that it comes from. And since they were the ones who wrote the original document - if they want it changed, totally up to them. But until that legal document gets changed - the text stays how it is.
I put my foot down about 7 years ago to ensure consistency and didn't have trouble until the person mentioned above showed up 3 years ago. Now it's just getting annoying.
> Assuming you're even half-competent as a tech writer, these people have no business wasting your and their time bickering over anything unrelated to the technical accuracy of the content. Your manager and their manager(s) need to make that clear. Maybe someone even higher up needs to make it clear to them.
I do well enough at my job. They keep giving me more work to do. And other offices in other parts of the country keep "borrowing" my templates.
> And if you're the Milquetoast type who's easily pushed around by everyone, you need to stiffen your spine. Talk to your manager about the situation and make it clear to him/her and to the bickerers that you can't continue to operate like this. Either you own the documents, or all the cooks spoiling the broth can just take the docs over and leave you out of it.
Manager has been talked to, several times. But my manager is more of a "it doesn't matter, do what they want" sort - he's tired of it being a discussion, so his solution is to just let them do what they want and give me other work to do. Which doesn't resolve the problem and is telling them that they can treat me however I want and that I have no authority and that he doesn't trust my judgement.
> If it comes to that, then Chris's suggestions are in order. :-}
Unfortunatly, unless I can find a virtual job I'm pretty well stuck where I am until my daughter turns 18. But believe me, I've been looking.
> Richard G. Combs
> Senior Technical Writer
> Polycom, Inc.
> richardDOTcombs AT polycomDOTcom
> rgcombs AT gmailDOTcom
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days. http://www.doctohelp.com
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-