Opening

Written by Mark L. Levinson

In this space, as weeks go by, I will touch on issues as micro as punctuation, as macro as audience analysis, and as meta as humoring collaborators. From time to time, for the sake of examples, I will refer to a fictional product such as TiePlumb, the computer-based photographic gauge for necktie straightness.

When you start reading the TiePlumb User Guide, be it a booklet or a help system, what should the first sentence say to you? I’ve seen some first sentences that say “Welcome,” I’ve seen “Thank you,” and I’ve even seen “Congratulations.”

“Welcome” is supposed to sound friendly, but to me it sounds arrogant and inaccurate. It says, “You are in our territory now. We are the proprietors and you are the disoriented stranger.” Wrong message. Not only does it turn the user frightened and defensive by asserting authority, it also addresses the user as a visitor on your turf when in fact your product is on the user’s turf. The user hasn’t gone to your office. You’ve come to the user’s computer.

The old TV programs used to say, more elegantly, “Thank you for welcoming us into your living room.” The exact reverse. So how about “Thank you for purchasing TiePlumb”?

While “Welcome” is too arrogant, “Thank you” is too obsequious. You owe the users thanks only if the users have gone beyond their own self-interest. But the attitude should be that of course it is in the user’s self-interest to purchase your product because it is a good product for a good price. What do you have to thank them for? For buying a necktie straightness gauge even though nobody needs one? For trusting you even though they can’t be sure your product is any good? Better not to let the user wonder what you’re so thankful about.

So if it’s a fine product, how about “Congratulations on selecting TiePlumb, the best necktie straightness gauge there is”? The problem there is double. First, you might alienate the reader if the reader isn’t the one who selected the product. And second, if your product is the best on the market, you benefit more from letting the user discover how good it is than by imposing the fact of superiority as a statement of your own. As Hemingway said, “If you tell it, you’ve lost it.”

You can remark that “we believe it is the best” or “it has been called the best.” That way you still leave the claim open for the users to confirm or dispute. Then when they find they agree, they will congratulate themselves on their good judgement and be happier with your product than if you tried to force the opinion on them up front.

So if not “Welcome,” not “Thank you,” and not “Congratulations,” what’s the right opening sentence? I think the best thing you can do is establish a baseline of understanding by telling the reader what the product is. “TiePlumb is a program that uses your computer’s camera and screen to help you gauge the straightness of your necktie.”

Comments and questions are welcome:

All Why of Style Articles

 

Useful Information

  • Job Listings (visible to only members)

  • Employee Benefits

  • Other Sites and Resources

    Survey Reporting

    Q2 2010 Survey Results

    Requires access rights

    Employee Salaries (18 pp)

    Freelance Writer Rates (11 pp)

    Q4/09 Copy Editor Rates (9 pp)


    Columns on Elephant

    Translatable but Debatable

    Each month, Mark L. Levinson presents one hard-to-translate Hebrew word at a time for discussion.

    Of Mice and Keyboard Shortcuts

    Michael Cohen will teach us practical shortcuts that save us time and make our lives easier.

    The Why of Style

    Mark L. Levinson examines the big and little factors that make writing effective.

    Broken Bell Education in Israel

    David Siegel looks at the problems in education in Israel and discusses what can be done.

    Jonathan's Tool Bar & Grill

    Jonathan Plutchok identifies free or inexpensive utilities or plug-ins that save time, increase productivity, improve your computing environment, perform a task you otherwise couldn't do... or is just too much fun to ignore. This column has grown into its own blog at http://jonathanstoolbar.blogspot.com where you can find new issues every week.

    It's in The Script

    Paul Schnall teaches us about the power of FrameScript and how to use it.

    Do it Yourself

    Did you ever wonder what was inside a PC, laptop, or other microcomputer system? Michael Cohen teaches us what's inside and how to configure and build our own.

    Coaching for Success

    Dr. Tal discusses the principles of professional coaching, focusing on resiliency.

    Hunters and Gatherers

    Eric Gluch looks at modern marketing.

    Moving to Chelm

    Esther Shira Stepansky takes us on a humorous adventure in the modern day land of Chelm as we look at some of the challenges of making aliyah and finding work in Israel. Making aliyah is supposed to be the fulfillment of my of your Jewish identity, so why does Israel make it so difficult?

    Why am I a Tech Writer?

    By Michael Altman

    Life as a Tech Writer

    By Mumpy

    Building Bridges (in Hebrew)

    Dr. Zaidel discusses another aspect of mediation within the framework of Israel's court-approved Alternative Dispute Resolution (ADR) process.

    Don't Forget

    Hezy Asher teaches us how to improve our memory.

    World of Podcasting

    Tom Johnson's podcast episodes, provide tips on recording presentations, and other podcasting related news and events.

    Effective Management ניהול אפקטיבי

    By Eitan Reuveni

    Scribblin' With Steph

    By Stephanie Freid

    Life in Northern Israel

    By multiple authors

    Life on the Southern Front of Israel

    By Israel Ivri

    Event Summaries

    Summaries of events held by Elephant and other organizations throughout the Israeli technical/marcom community.