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.
style guides: persuasion to follow rules or enforcement
Subject:style guides: persuasion to follow rules or enforcement From:"Katriel Reichman" <katriel -at- methodm -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Thu, 7 Jun 2007 11:39:48 +0300
One approach to getting writers (including product managers, pre-sales and
other non-technical writers) to follow style guides or "policies for working
with Word" is rely on goodwill (or gentle arm-twisting - see Jawboning
<http://en.wikipedia.org/wiki/Jawboning> ). Another approach, less common,
is build-in compliance to the authoring/editing process. In other words,
enforce compliance. Enforcement sounds draconian, but heck - a lot of
people pay taxes because they're afraid of being audited. A lot of people
use crazy styles, local formatting, and commit other cardinal sins because
(1) it's easier than following policies and (2) there is no enforcement
mechanism.
I am interested to hear experiences/opinions on
a) the efficacy of compliance enforcement vs. gentle persuasion.
b) can/should compliance efforts be directed beyond technical writers to
other staff who create lots of documents.
Looking forward to feedback,
Katriel
Katriel Reichman
Method M Ltd. - the method is in the message
<mailto:katriel -at- methodm -dot- com> katriel -at- methodm -dot- com,
<http://www.methodm.com/> www.methodm.com/blog/, www.methodm.com/author-max/
(tool for improving Word productivity, quality and consistency; download
available).
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-