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.
> I referred to the second
>edition MS Manual of Style, published in 1998, which offers the following
>advice under CD:
>
>"It is acceptable to use the abbreviation CD alone if there's no possibility
>of confusion with other compact disks, such as CD-R (recordable)."
Glad to see they've come around. Didn't know there was a newer edition.
>Obviously, the MS Manual of Style is not the be-all, end-all of
>decision-makers, but we make Windows software, so we adhere to it.
I don't see the logic in that. If the software gets ported to Linux, will you
wait for a Linux style guide before updating the docs? We make software that
runs on Solaris, but we don't necessarily adhere to Sun's style guide (not that
I have anything against it). It's your company's software -- why adhere to
another company's style guide?
--
Regards,
John Wilcox - Senior Technical Writer, TCSI Corp., Bothell, Washington USA
Sometimes you gotta create what you want to be a part of. -- Geri Weitzman
