Thursday, May 14, 2009

Does it have a hyphen?

Years ago, I discovered that the surest way to throw a roomful of technical writers into an uproar is to ask, as innocently as possible, "Does the term 'anal-retentive' require a hyphen?"
Don't take my word for it. Try it yourself - but only if you've already concluded the business at hand, and still have an hour or two to spare.

Spirited discussions of grammatical questions are like crack for writers. They give us such a buzz every time. We feel so great, so smart, so right. It's what we live for. We can't stop. We can't get enough. We don't want to hear that they interfere with our lives and damage our productivity, and we really don't want to hear that they're an inappropriate use of a designated meeting time or discussion forum.

The only difference between writers and crackheads is that we're not likely to get arrested for possessing grammar books. Today I witnessed this truth play out in a dramatic, time-consuming, and very public way.

As in music or dance, it's impractical to strive for perfection in writing. We have to settle for attaining a level of skill that allows us to make a living at it. And our goal must be to communicate effectively, rather than to be excruciatingly correct. A technical writer's mission is to help people understand things. If we have to make a choice between clarity and correctness, we have a professional obligation to choose clarity; though in almost every case a bit of rewriting will allow us to serve both those masters.

Most of us are acquainted with the anecdote usually attributed to Winston Churchill: Upon seeing one of his sentences rewritten in a cumbersome fashion to keep it from ending with a preposition, Mr. Churchill allegedly said "This is the sort of nonsense up with which I will not put."

Regardless of the true origin of the quote, the point is valid: Clear communication is the objective. Get the grammar right enough that it doesn't interfere with your message - that is, right enough that it doesn't strike your audience as wrong - and move on. It's one more matter that comes down to knowing your audience, and recognizing that sometimes tech writers are not the audience.

15 comments:

  1. This post will assist the internet viewers for building up new weblog or even a blog from start to end.
    Here is my web-site : real money slots online

    ReplyDelete
  2. Its not my first time to go to see this web site,
    i am visiting this site dailly and obtain good data from here daily.
    Here is my web site forex signals

    ReplyDelete
  3. Right now it appears like Drupal is the best blogging platform out there right now.

    (from what I've read) Is that what you are using on your blog?
    Also see my web page :: Monopoly Online Roulette

    ReplyDelete
  4. This is a topic that's close to my heart... Best wishes! Exactly where are your contact details though?
    my web site > best binary

    ReplyDelete
  5. I know this if off topic but I'm looking into starting my own blog and was wondering what all is required to get set up? I'm assuming having a blog like
    yours would cost a pretty penny? I'm not very web smart so I'm not 100% certain. Any suggestions or advice would be greatly appreciated. Appreciate it
    Also see my site > play roulette Online for real cash

    ReplyDelete
  6. Ahaa, its fastidious dialogue on the topic of this paragraph
    here at this web site, I have read all that, so now me also commenting at
    this place.
    Also visit my web-site - play roulette online for money

    ReplyDelete
  7. I know this if off topic but I'm looking into starting my own blog and was wondering what all is required to get setup? I'm assuming having a blog like yours
    would cost a pretty penny? I'm not very web savvy so I'm not 100% positive. Any recommendations or advice would be greatly appreciated. Thanks
    Look at my site : online jobs work from home part time

    ReplyDelete
  8. Howdy are using Wordpress for your site platform? I'm new to the blog world but I'm trying to get started and set up my own.
    Do you require any coding knowledge to make your own blog?
    Any help would be really appreciated!
    My web site :: Part Time Jobs From Home Online

    ReplyDelete
  9. Undeniably believe that which you stated.
    Your favorite reason seemed to be on the internet the simplest thing to be aware of.
    I say to you, I certainly get irked while people consider worries that they plainly don't know about. You managed to hit the nail upon the top as well as defined out the whole thing without having side effect , people could take a signal. Will likely be back to get more. Thanks
    My website ... forex for dummies

    ReplyDelete
  10. I am extremely inspired with your writing skills as neatly as with the structure on your
    blog. Is this a paid topic or did you modify it yourself?
    Anyway keep up the excellent quality writing, it is rare to look a great blog like
    this one today..
    Here is my web-site - best place to look for jobs online

    ReplyDelete
  11. I blog often and I genuinely thank you for your information.

    This great article has truly peaked my interest.
    I will book mark your site and keep checking for new information about once per week.

    I subscribed to your Feed as well.
    Here is my web site - play roulette online for real money

    ReplyDelete
  12. I could not refrain from commenting. Perfectly written!
    My page > find an online job

    ReplyDelete
  13. First off I would like to say awesome blog! I had
    a quick question which I'd like to ask if you don't mind.
    I was curious to find out how you center yourself and clear
    your mind before writing. I've had difficulty clearing my thoughts in getting my thoughts out. I truly do enjoy writing however it just seems like the first 10 to 15 minutes tend to be lost simply just trying to figure out how to begin. Any suggestions or tips? Kudos!
    Here is my site - how to get a job with no experience

    ReplyDelete
  14. I've been browsing on-line greater than 3 hours these days, yet I by no means discovered any interesting article like yours. It's lovely price
    enough for me. In my view, if all web owners and bloggers made just right content material as you probably did, the internet will probably be a lot more useful than ever before.
    Also visit my web page best forex trading system

    ReplyDelete
  15. Just wanted to say I love reading through your blog and look forward to all your posts! Carry on the great work!

    Greetings from Lorca

    ReplyDelete