Can it be both raw and right?

 by Mark L. Levinson

I was at my usual table near the back, and from outside on one of the better established, less flashy streets of Yokneam’s technical writing district the beams of an occasional taxi brightened the vintage Ms. Pacman machine in the corner of the joint like a sudden bonus score as some foreign businessman returned to his swank hotel.

Adri walked in from the hamseen.  “Two frozen yogurts,” I called to old Genady.

“Pour some pisang on mine,” said Adri, removing his dusty eyeglasses.  “It’s been an infuriating day.”

“Downgrade back to Win XP and wait a year,” I said.

“It’s not that,” said Adri.  “It’s the SMEs.  Small-minded engineers.  One of them came to me today with a draft spec he’d written and you know what he said? ‘Make it pretty.’”

“So what did you say?”

“Nothing.  I was too polite.  No, I was too angry.  No, I was too slow-witted.  But I know what I should have said.  Pretty is a by-product.  We make it clear, we make it accurate, we focus it.  The meaning isn’t there for the reader until every word is in its ideal place and they all connect like a printed circuit.  If you haven’t said it right, you haven’t said it.  You can’t separate the content from the presentation.  There’s no such thing as sloppy but accurate.  How can the content be right when the language is wrong?  The language is the content.

“Pretty?” he fumed.  “You bet it’s pretty when we’re finished.  Not random pretty like a basket of daisies.  Planned-out pretty like a, like —”

“Like a straight seam in a silk necktie,” I said.  “Well, there’s no convincing these people.  They think —”

“But it gets worse,” said Adri.  “I had a manual ready for technical review, so I passed it to the chief programmer.  He kept it for a week, and when he handed it back, you know what he’d done?  He had arrows pointing out how he wanted material rearranged.  He’d even corrected my English.  You know what I told him?”

“Nothing, I’ll bet.  But what should you have told him?”

“I would have, but I was too —  I should have told him, I’m the professional writer here.  I’m not asking you whether the English is correct.  Of course it isn’t.  This is just a draft.  A raw, raw draft.  Why should I sweat the English?  And who cares if half the parameters are explained before the procedure and half are after the procedure?  I’ll take care of all that window-dressing later.  Right now I only want to know if the content is correct.  Focus on the content, never mind the presentation.  Is that hard to understand?  They’re two separate things.”

“It’s like I said,” I said.  “There’s no convincing these people.”

“You know you guys are crazy?” said old Genady.  “Has the hamseen got to you?”

“And you, have you been hitting the pisang?” said Adri.  “What do you mean, we’re crazy?”

“You tell one person that the way you write the material makes it right or wrong, but you ask another person to tell you whether it’s right or wrong before you’ve written it correctly and you’re angry that he tries to correct the writing.”

Adri looked at Genady.  Genady walked away.  Adri looked at me.

“It’s not like it was the same person,” he said.

Comments and questions are welcome: 

 

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.