RE: Purpose Statement for Style Guide

Subject: RE: Purpose Statement for Style Guide
From: Stephen -dot- MacDonald -at- Aspect -dot- com
To: TECHWR-L -at- LISTS -dot- RAYCOMM -dot- COM
Date: Fri, 7 Jul 2000 08:01:54 -0400

Rebecca wrote:

> Our new management thinks that our Style Guide is a luxury and a waste of
> time. Can you provide me with some well-thought-out arguments as to why a
> tech. pubs. team would "need" to have one?

Are you saying they think the current one is a problem or they are opposed
to a style guide altogether? If it's the former, they might have a point.
If it's the latter...

IMO, the consistency and clarity resulting from a good style guide produce
lower documentation maintenance costs and fewer service calls. Those things
alone should be enough to justify it, but most places don't have the data to
prove it.

I would certainly enlist the help of your service organization. Most folks
in that world have found over time that a good doc set helps them
tremendously.

Steve MacDonald
Aspect Communications, Inc.






Previous by Author: RE: SMEs
Next by Author: Re: Productivity Metrics
Previous by Thread: RE: Purpose Statement for Style Guide
Next by Thread: RE: Purpose Statement for Style Guide


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads