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.
Hi, everyone. Is anyone else here laboring in the vineyards of
electrical engineering?
I'm working on a manual about circuit breakers, and various stylistic
problems keep coming up. My question to fellow EE writers is, do you
have a style guide or other resource that you draw on to help sort out
problems like the ones I am about to list?
I've looked at IEEE publications, and there are many, but I haven't been
able to identify or get my hands on the one that might contain the
standards I need.
OK, here's what I'm mostly dealing with:
1. Noun clusters. I'm trying to walk the fine line between overly
simplifying things (because of my own ignorance) and leaving unnecessary
noun clusters in place.
Example: Contact open â travel OCB/overall test/one break per phase
breaker
This is the proposed caption of a figure provided by an engineer. This
engineer sees no problem with this wording, but even though I am not an
electrical engineer, I do. My only hope is to ask the product manager,
who is my boss, to review these with me one by one and either approve
them or suggest revisions.
2. Inconsistent capitalizations. All of the illustrations show wave
forms that reflect the opening and closing of breakers. There are a
zillion possible combinations, because breakers have different numbers
of contacts and they open and close in synchronized ways. One figure
caption is this: Reclose Open-Close Time.
I'm willing to believe that it is meaningful . . . but I have trouble
with a related sentence that says "The Reclose Open-Close Time, as shown
in Fig XX, is . . . ." Opening and closing is what circuit breakers do,
and it's what a 400-page manual is all about. Are these terms therefore
capitalized? In some contexts, but not others? As in "The circuit
breaker opened," but "The circuit breaker Open rate is 8.3 ms"?
3. Inconsistent terms. "Close time" or "Closing time" -- these terms
occur interchangeably in the document, and there are plenty of other
inconsistencies.
EE writers -- how do you handle this stuff?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-