What Does a Technical Writer Really Do?

Technical writing in Israel is not just about gathering technical information and putting it down on paper.

It's really about gathering, organizing and distributing information to provide an inexpensive solution to an expensive problem. Your product or service may be the best, but if customers don't know how to use it - they won't. If you can't get your first line of support up and running quickly - you foot the bill.

To do this, technical writers often need to identify what the real needs are because clients and employers don't always know. And once we do identify those needs we need to meet them WITHOUT a budget. Understanding technology helps, knowing how to write is important too. But it's not always enough.

This is why many of the workshops at elephant deal with organizational skills like community building, coaching and negotiating skills. Some of the new columns that are planned will deal with these related skills that are not usually part of our job description, but help us get the job done.

One of the topics that I would like to have discussed here is Alternate Dispute Resolution (ADR) or Gishur in Hebrew. Although intended for resolution of disputes, many of the techniques used in ADR can be applied to needs analysis and information gathering. You want information - you need to know how to get it. If marketing tells you about one set of product features and teh developer tells you about something that doesn't really seem to match up - you need to get them to discuss the differences and make a decision quickly - who cares if its your job.

If you have a topic that you would like discussed in a column or at a workshop let me know. If you know of a good speaker have him/her contact me at .

 

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.