Re: terminology question (and a bit of a rant)

Subject: Re: terminology question (and a bit of a rant)
From: kcronin -at- daleen -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 3 Sep 2002 13:37:51 -0600

If the actual CONTENT of the manual is correct, you are spinning your
wheels, and run the risk of annoying your boss.

But if you really want to go out on that limb, go out and BUY yourself a
Microsoft style guide (as opposed to requesting one), learn how The Big
Boys do it, and then use The Power Of Bill to back up your arguments.
Unless it conflicts with how YOU want the styles to be, in which case
you're back at square one.

But I gotta ask: If you're the only person writing online help, isn't this
all a waste of time? You already know how you want to do things. Do YOU
really need a style guide to tell you how you already write?

If you have the power to impose your styles on whoever is writing the
manual, then knock yourself out, and lay down the law to the other
writer(s). But only if it's REALLY the most important thing you should be
doing right now. Is it?

It does sound like there are some inefficiencies/redundancies in the way
your company produces documentation. But I hope you won't add to it by
forcing somebody else to reinvent their wheel to look nice next to your
wheel. (Hmmmmm, can I find any *other* way to use a wheel metaphor in this
post, or is two times enough?)<g>

Instead, perhaps you could provide more value to your company by
suggesting ways to eliminate redunancy of effort in producing
documentation. To me that would be way more valuable than making some poor
schlub worry about what to call a screen in a doc that's only going to be
used internally.

Pick your windmills with care!

Keith Cronin

Please respond ONLY if you agree with me. I am not interested in receiving
any actual advice, and merely want to establish that my opinion is the
only valid one to have under these circumstances. I need empathy and
validation, not solutions!

Check out the new release of RoboDemo, our easy-to-use tutorial software.
Plus, buy RoboHelp Office in August and save $100 with our mail-in rebate.
Get details and download free trial versions at

Acrobat & FrameMaker Seminars: PDF Best Practices, FrameMaker-to-Acrobat
Advanced Techniques, FM Template Design, Single Sourcing with FrameMaker
in Brussels (Oct), and in Montreal & Dallas (Dec):

You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: perils of job hunting
Next by Author: Re: Tuesday's news: cost-cutting measures
Previous by Thread: RE: terminology question (and a bit of a rant)
Next by Thread: Re:terminology question (and a bit of a rant)

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

Sponsored Ads