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: Out of Style? From:"Kelly Williamson" <kwcwtech -at- iwaynet -dot- net> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Tue, 12 Jun 2001 15:13:26 -0400
"Longtime Tech Writer" wrote (several days ago) that his/her company makes
him/her do the following:
> 1. In chapter titles, all words longer than three
> letters are set in initial caps. This includes
> prepositions. Has anyone ever heard of this style
> before? FYI, we use common sentence-style
> capitalization for headings within chapters.
(Sorry if someone already made this point)
This style leaves out certain verbs, such as "is", and you should capitalize
all verbs in title case, no matter how short. (That Subway commercial always
bugged me: "Where Fresh is the Taste")
As Clinton would say, I guess it depends on what the meaning of the word
"is" is (hehe, just had to throw that one in there.)
As far as their rule about the colon after "follows", that's pretty darn
silly and arbitrary. Using a colon has nothing to do with the word
"follows". If they really want to use it correctly, they would say only use
it at the end of a complete sentence when a list follows.
As far as some folks saying you're getting all bent out of shape over
nothing, I would probably have the same issues you are having if faced with
this situation. No, you shouldn't sweat the small stuff, but you should also
educate your co-workers and show them why you don't like it (maybe they just
really don't know any better). It makes them look bad IMO. If someone who
does knows better ever sees the style guide, they're going to think the doc
group is a bunch of amateurs! (If, after having educated them, they still
outvote you, then you can decide not to sweat it.)
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com
Sponsored by Cub Lea, specialist in low-cost outsourced development
and documentation. Overload and time-sensitive jobs at exceptional
rates. Unique free gifts for all visitors to http://www.cublea.com
---
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.