Re: Technical writing in a higher ed environment

Subject: Re: Technical writing in a higher ed environment
From: <technicoid -at- cableone -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 18 Mar 2004 09:10:08 -0700

>Much of my content (quick guides, cheat sheets, basic 'how to'
>information, etc.) is distributed electronically via the Web site and
>is subject to this "law." But AP doesn't even come close to meeting my
>needs. In fact, it often contradicts Chicago and other style guides
>commonly used in technical documents.

First and foremost, a style guide is a tool for ensuring consistency. You can be clear and
concise irrespective of the guide you use. However, if the AP guide doesn't provide guidance on
matters specific to the context in which you write, you should be able to provide examples to
demonstrate its deficiencies.

Put together an argument for using additional resources and pitch it to whomever makes the
rules. I'd be surprised if they balked at you using additional resources. You might have to
defer to AP style for some matters, but at least you'll have covered all bases.

technicoid -at- cableone -dot- net


ROBOHELP X5 - ALL NEW VERSION. Now with Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more!

Now is the best time to buy - special end of month promos, including:
$100 mail-in rebate; Free online orientation on content management
functionality; Huge savings on support and future product releases;
PLUS Great discounts on RoboHelp training. OFFER EXPIRES March 31!
Call 1-800-358-9370 or visit:

You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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: Doc comparisons in Framemaker MAKING ME NUTS!!!
Next by Author: RE: External localization?
Previous by Thread: Re: Technical writing in a higher ed environment
Next by Thread: RE: Re: Technical writing in a higher ed environment

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

Sponsored Ads