Random comments on common errors in technical documents

Status
This old topic is closed. If you want to reopen this topic, contact a moderator using the "Report Post" button.
This thread was prompted by a post in another thread. To avoid going off-topic, I have put my thoughts here. Comments/discussion welcome!

Plurals don't have apostrophes, and that includes decades and acronyms. e.g. "1980s" for "nineteen-eighties" (1980's means: "belonging to the year 1980") and "LTPs" for "long-tailed pairs" (LTP's means: "belonging to the long-tailed pair").

As specified in official style guides, numbers and their units should be separated by a non-breaking space (e.g. "1 kHz" not "1kHz"). Non-breaking spaces can be typed in Word by pressing shift-control-space (on Windows) or option-space (on Mac OS X).

The dash, the hyphen and the minus sign are all different ascii characters and the appropriate character should be used at the appropriate time. In particular dashes are often erroneously used as a minus sign. The minus sign is accessible in the OS-supplied character palettes in Windows and OS X.

Similarly, the letter "x" is not the same as the multiplication character. Again the multiplication character can be accessed from the OS-supplied character palettes in Windows and OS X.

"it's" means "it is" or "it has" and "its" means "belonging to it".
 
Last edited:
And a couple of my favourites so Harry doesn't feel like he talks to himself.;)
Complementary transistors are NOT complimentary.
For units named after people, the word is spelled all lower case but the symbol is upper. So one henry is 1 H but one Henry is Lenny.

David
 
Last edited:
Member
Joined 2009
Paid Member
My favorite is when time is specified in Siemens. Conductance is measured in Siemens (S). Time is measured in seconds (s). 1 ns != 1 nS. Never mind when people try to measure time in Newton-Siemens. 1 NS != 1 ns.

Or currents through a tiny device is measured in mega-ampere. There's a big difference between 1 mA and 1 MA. A factor of 1000000000 to be exact.

It's really not that hard. Prefixes less than 10^0 are all lower case. Prefixes greater than 10^0 are all upper case except k for kilo, which is lower case.

~Tom
 
Something which often crops up is 'of' instead of 'have' e.g. "you should of done it this way". I once had to correct this for a technical college lecturer - he needed a lot of convincing that his comment on my work was illiterate!

There is a danger with this type of discussion: we might agree that people should try harder, but I suspect we all put the borderline between reasonable effort and pedantry in different places.
 
As non-English speaker, I want to exploit this tread to ask what is correct with negative expressions:

doesn´t or doesnt

can´t or cant

don´t or dont.

haven´t or havent.

I have learned English of my own when boy, and all the teachers uses the apostrophes, but I see anywhere that don´t use them.

Thanks in advance.
 
Administrator
Joined 2004
Paid Member
What you have listed above is called a "contraction". It's a shorting of the word by leaving out a letter or sound. When written, the missing letter is replaced by the apostrophe. That's the correct way to do it, don't you know? ;)
 
Administrator
Joined 2004
Paid Member
Something which often crops up is 'of' instead of 'have' e.g. "you should of done it this way".
That's spelling trying to follow speech, isn't it? The word "have" gets swallowed in that phrase sounding like "should uhv". Many folks mistake that for "should of". (Voiced/non-voiced). But you knew that, of course.

Similar, in the US at least, is pronouncing "has" as "is" in a phrase. It's sloppy, but common - I hear newscasters do it all the time. "The president is signed a new bill". No one writes it that way, tho.
 
What you have listed above is called a "contraction". It's a shorting of the word by leaving out a letter or sound. When written, the missing letter is replaced by the apostrophe. That's the correct way to do it, don't you know? ;)
Certainly I don´t know. The automatic spelling check in this PC refuses both with, and without the apostrophes. And Spanish (In fact, I must tell Argentinian language) don´t use the negative form i the verb itself, nor apostrophes, so I really don´t know what is good and what not.
 
Certainly I don´t know. The automatic spelling check in this PC refuses both with, and without the apostrophes. And Spanish (In fact, I must tell Argentinian language) don´t use the negative form i the verb itself, nor apostrophes, so I really don´t know what is good and what not.

Maybe you're not using the apostrophe key? Certainly what you're typing here is not an apostrophe. What you typed in your post above is this character: ´ (which according to OS X is an ASCII acute accent), but you should be using this one: ' (ASCII apostrophe).
 
Last edited:
Administrator
Joined 2004
Paid Member
"Don't you know" is an English idiom - not a direct question, sorry. Similar to n'est pas? in French.

Must be your spell checker, or your apostrophe. You are not using the standard apostrophe, but more what we would call an "accent" mark. I'll check the ascii code for you.
 
Administrator
Joined 2004
Paid Member
OK, looks like your keyboard is giving you the acute accent character, as Harry mentions. That should be Alt 0180 for those without a Spanish keyboard. ´´´´ The apostrophe is Unicode 0027, but I don't know how to get that other than directly on the keyboard. '''''''

I think that's why your spell checker doesn't like it. Copy and paste my spelling of -- doesn't, hasn't, won't -- and see if the checker accepts it.
 
Status
This old topic is closed. If you want to reopen this topic, contact a moderator using the "Report Post" button.