Re: punctuation et al. rules

Subject: Re: punctuation et al. rules
From: Ant Davey <ant -at- ant-davey -dot- com>
To: Ken Poshedly <poshedly -at- bellsouth -dot- net>, TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 21 Feb 2017 11:33:32 +0000 (GMT)

Hi Ken,

The way to win the argument is to ask your boss 'What if there were two
of these connectors?'

What would he do with 7 pin connectors? And if it works for two, why
not one?

HTH,

Ant

On 20 February 2017 at 20:18 Ken Poshedly <poshedly -at- bellsouth -dot- net>
wrote:

Here's a quickie.

I work for a manufacturer of a China-based, heavy construction
equipment. Now that's, REAL hardware.

Most of our source material is English-language stuff is right from
the company's offices in mainland China, where their
English-language skills are fair at best. The remainder of our
source material is what we here write IF we are lucky enough to have
the machine here on our premises for photos and inspection.

My American manager is a nice guy (about age 60, and I'm seven years
older) but he is not a true tech writer. He is an ex-Marine who had
written the technical stuff for a heavy equipment dealer where he
was employed for some years, and very proud of it. And he certainly
knows his stuff from a technical side of things. Absolutely. Many
times, he'll forward a Word document for me to format (we use
FrameMaker 11.0) that he has written and I'll usually find little
stuff to fix, but then he'll quibble with me about it. I usually
give in because he's the boss.
In today's document from him is the phrase "7 pin connector". My fix
was to simply add a hyphen to make it "7-pin connector". But he
objected and I VERY diplomatically told him that in our industry, it
is common to take mechanics and other factory workers with oodles of
line experience and throw them in front of a keyboard to write the
manuals, thus the rough grammar, etc. And blindly copying what
somebody else wrote means replicating their errors (if any). He
agrees but says that he has NEVER seen various things that I show
him in any other tech manuals by other companies in this industry.
So what is the official rule for the use of hyphenated modifiers.
Like I said, this is VERY minor but good writing is supposed to be
correct in punctuation as well as word usage, etc. And this isn't
even a tech writing rule, but a punctuation rule that should apply
everywhere.

So if anyone has a website (ESPECIALLY a heavy construction
equipment website) that shows correct usage, or a website that
states the correct punctuation rules, I'd be much obliged.
Hopefully, I'll be able to reference it for future "things."

-- Ken in Atlanta
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content
strategy and content development | [1]http://techwhirl.com

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

You are currently subscribed to TECHWR-L as ant -at- ant-davey -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
[2]http://www.techwhirl.com/email-discussion-groups/ for more
resources and info.

Looking for articles on Technical Communications? Head over to our
online magazine at [3]http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our
public email archives @ [4]http://techwr-l.com/archives

References

1. http://techwhirl.com/
2. http://www.techwhirl.com/email-discussion-groups/
3. http://techwhirl.com/
4. http://techwr-l.com/archives
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

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

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
punctuation et al. rules: From: Ken Poshedly

Previous by Author: RE: punctuation et al. rules
Next by Author: Re: Conversion of PDF to word
Previous by Thread: Re: punctuation et al. rules
Next by Thread: Re: punctuation et al. rules


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

Sponsored Ads


Sponsored Ads