Writing SI units and symbols

Quite a few of us do not write the SI units correctly. If you are a Physics or Chemisty student, and still remember what you studied in school, you'll know the importance of getting your units and symbols right.

Important in SI:

1. The short forms for SI units (such as mm for millimeter) are called symbols, not abbreviations.
   
   
2. SI symbols never end with a period unless they are the last word in a sentence.
   
   
   
   
   
   • RIGHT: 20 mm, 10 kg
     
     
   • WRONG: 20 mm., 10 kg.
     
     
   
   
   
3. SI symbols should be preceded by digits and a space must separate the digits from the symbol.
   
   
   
   
   
   • RIGHT: It was 300 mm wide. The millimeter width was given.
     
     
   • WRONG: It was 300mm wide. The mm width was given.
     
     
   
   
   
4. Symbols always are written in the singular form (even when more than one is meant).
   
   
   
   
   
   • RIGHT: 1 mm, 500 mm, 1 kg, 36 kg
     
     
   • WRONG: 500 mms, 36 kgs
     
     
   • BUT: It is correct to pluralize written-out metric unit names: 25 kilograms, 250 milliliters
     
     
   
   
   
5. The symbol for a compound unit that is a quotient of two units is indicated by a solidus or by a negative exponent.
   
   
   
   
   
   • RIGHT: km/h or km·h^-1 (for kilometers per hour)
     
     
   • WRONG: kmph or kph (do not use p as a symbol for "per".)
     
     
   • BUT: It is correct to say or write "kilometers per hour".
     
     
   
   
   
6. The meaning of an SI symbol can be changed if you substitute a capital letter for a lower case letter.
   
   
   
   
   
   • RIGHT: mm (for millimeter, which means 1/1000 of a meter)
     
     
   • WRONG: MM or Mm (M is the prefix for mega, which means one million; a megameter is a million meters)
     
     
   
   
   

Links:

potsdam.edu

poynton.com

lamar.colostate.edu


Write to me: Suman[at]sumankumar[dot]com

Read More

Travails of a tech writer

Lot of people ask me what I do for a living. When I say 'Tech writer.' they go, 'What's that?'. And I explain,

'What do you do when you are stuck with MS-Word or Excel?'

'Call the guy that sold me the computer?'

And I'd hide my exasperation and pain,

'No, I mean, it is 2 a.m. and you can't call anyone.'

'What's the big deal? I'll call the next morning, but hey,you haven't told me what you do as a tech writer man.'

And I'd resign saying, 'I write help. Like when you hit F1 on MS-Word, you know?' And my audience would groan, 'ohhhh! Never read that stuff.' A pause. And, 'Is that it?'

There. Do you see my misery?

My audience includes lay people, software engineers, undertakers, tea-tasters, musicians, and my dad. Phew. All you guys, read this:

God I hate writing help files. I'll never be able to be a technical writer. How do those people do it? There are actually technical writing sites that are devoted to the love of the profession. I seriously admire these people. It takes nothing but love and hard work to be good at this (much like C++..?). And all I'm trying to do is make a simple help file on The Regulator. Geez. You'd think I'd have done it by now, 4 days after starting, but no. I only have like one page and a basket full of chocolate wrappings(kidding... we're trying to have the least amount of chocolate available in the house, specifically for situations such as this). So. any suggestions? anyone else wants to help me write this thing? I promise a serious credit in the about :)



To be honest, I've never had to do this before. Sure, I've written many technical documents, but documents that say “click this then you'lll see this so click that to get this” are simply ....ugh!

(via rosherove)






Write to me: Suman[at]techwritersindia[dot]com

Read More

Finding the voice

Excerpt from LOUIS MENAND's review of Eats, Shoots & Leaves: The Zero Tolerance Approach to Punctuation” (Gotham; $17.50), by Lynne Truss.

"Does this mean that the written "voice" is never spontaneous and natural but always an artificial construction of language? This is not a proposition that most writers could accept. The act of writing is personal; it feels personal. The unfunny person who is a humorous writer does not think, of her work, "That’s not really me." Critics speak of "the persona," a device for compelling, in the interests of licensing the interpretative impulse, a divorce between author and text. But no one, or almost no one, writes "as a persona." People write as people, and if there were nothing personal about the result few human beings would try to manufacture it for a living. Composition is a troublesome, balky, sometimes sleep-depriving business. What makes it especially so is that the rate of production is beyond the writer’s control. You have to wait, and what you are waiting for is something inside you to come up with the words. That something, for writers, is the voice."

Write to me: Suman[at]techwritersindia[dot]com

Read More