Re: Style guides?

Subject: Re: Style guides?
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: "Lisa C. Boyd" <lisab -at- lisaboyd -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 23 Dec 2005 13:14:38 -0800

Beware the temptation to load up on style guide books. At one
of my previous companies, the corporate style was managed by
an editor whose ideas about style were, to say the least, "unique."
And no matter what question was raised about his formats, he
was able to pull an "authoritative source" off a bookshelf to
"support" it (he had about a dozen "authoritative sources", many of which often contradicted each other on a given issue). The
resulting template, needless to say, was a hopeless morass of conflicting elements.

My advice: pick one or two you like, stick with them in the
face of other "sources," but don't be afraid to violate them if common sense tells you something else is called for.

Gene Kim-Eng


----- Original Message ----- From: "Lisa C. Boyd" <lisab -at- lisaboyd -dot- com>

Being new to technical writing and wanting to do things right from the start, what style guides do you recommend? Recent discussions on the list have tested me in what I thought were the right ways to write terms. So what are the "must haves" in style guides?


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l

Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author content and configure Help in MS Word or any HTML editor. No proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


References:
Style guides?: From: Lisa C. Boyd

Previous by Author: Re: Style guides?
Next by Author: Re: Don Norman on Manual Writing
Previous by Thread: RE: Style guides?
Next by Thread: Re: Style guides?


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


Sponsored Ads