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.
Subject:Re: anyone else in the same boat? (LONG) From:Bruce Byfield <bbyfield -at- axionet -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 22 Dec 2000 10:48:05 -0800
Lydia Wong wrote:
>
> - No the engineers don't care about your style guide, but you as a writer
> should. Don't spend a lot of time on this, though. Pick one, use it, and do
> your work. If your company doesn't have one, pick one that works for you and
> move on. (Chicago Manual is a popular choice, as is the Microsoft Manual of
> Style, depending on your product and audience.) Style guides help us be
> better writers, and someday when you get another writer, you'll have your
> style decided. One less thing to worry about.
One reason not to be overly concerned with style guides is that the
standards are likely to evolve and change over your first few
projects. Like grammar, a style guide is most useful when it is more
descriptive than prescriptive.
Also, a style guide only really starts to be useful when more than
one writer is on the job. A lone writer has less immediate need for
one. However, it's a good idea to keep notes against the day when
the number of documenters makes one useful.
--
Bruce Byfield, Outlaw Communications
Contributing Editor, Maximum Linux
604.421.7189 bbyfield -at- axionet -dot- com
"When Laertes heard his Dad has been stabbed in the arras,
He came racing back to Elsinore tout suite, hotfoot from Paris,
And Ophelia, with her Dad killed by the man she wished to marry,
After saying it with flowers, committed hari-kari."
- Adam McNaughton, "Our Hamlet" ("The Three Minute Hamlet")
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY. http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Take XML and Tech Writing courses online! Our instructor-led courses
(4-6 hrs/wk) give you "hands on" experience at your convenience. STC members
get 20% off! http://www.online-learning.com/index.html.
---
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 http://www.raycomm.com/techwhirl/ for more resources and info.