• Skip to main content
  • Skip to secondary menu
  • Skip to primary sidebar
  • Skip to footer
  • Home
  • About me
  • Contact

Joel Solkoff

High-tech housing for the poor, disabled and elderly

Chinese (Simplified)EnglishFrenchGermanHebrewItalianPolishPortugueseRussianSpanish
  • Disability and Elderly Issues
  • Food
  • Architects for Change
  • Joel Solkoff’s Resume
  • Joel’s Books
You are here: Home / Disability and Elderly Issues / How I became a technical writer in the Silicon Valley

How I became a technical writer in the Silicon Valley

June 28, 2017 by joel Leave a Comment

A good way to communicate is to tell a story. Here is mine. The purpose of my telling is to help you tell your story especially if your story concerns your high technology business and if you do not feel especially comfortable writing.

I became a technical writer by accident. It was Labor Day of 1990. My wife Diana pulled up the family Ford to the headquarters of the U.S. Postal Service in Washington, D.C. where I had originally been hired to write speeches for the Postmaster General. I was 43 years old and not at all happy with my job. My wife Diana was working for the U.S. Department of Commerce as international economist negotiating textile and apparel agreements. Diana had negotiated in India, Bangladesh, and China. Her title was impressive. So was mine.

Together we had trouble making our mortgage payments. The public school system in Washington D.C., once the envy of the world, had declined tragically since the end of World War II. My six year old daughter Joanna was in first grade and learning very little. My second daughter Amelia was less than a year old.

++++

Often it may become necessary to interrupt. I am interrupting myself to let you know where the story is going and why. The story ends at a Christmas party for a startup company in the Silicon Valley of California. The company was founded by entrepreneurs who were born in India but relocated to the U.S.—to San Jose specifically—because of opportunity. They saw the opportunity to develop a relatively-small switch for data transmission. I had been hired under contract to write a user’s guide. The subject of the guide was highly-technical.

The guide’s purpose was to help readers who were eager to use new technology to make their business successful. Some experience with the basics of data transmission was assumed. My readers knew something about digital transmission, but I had to write clearly and simply. Perhaps a new employee had just been hired who was in the process of being trained. My manual had to be understandable to the relative novice (without talking down to her or him) and yet also worth reading for an experienced hand. What is the first thing I needed to do to write such a document?

The first thing I needed to do was understand the subject.

++++

Spoiler alert for the return to the story. The family Ford was going to Diana’s best friend Betsy who lived outside Charlotte, North Carolina. On the way, we stopped in the Research Triangle Park area of North Carolina. Specifically, we stopped at the home of Patric and Trina Mullen. Patric was an old friend. He had been a lobbyist in Washington, D.C. introducing me (when I was a newsletter editor relatively young to my profession) to members of Congress helpful to me. In return, I included his observations into articles I published. It was not simply tit for tat. We were friends with a similar world view which had extended itself to his relocation to North Carolina then booming with major advances in education and in attracting high technology business.

One of the businesses North Carolina had attracted was Northern Telecom, a Canadian based manufacturer of digital telephone switches which for decades had brought prosperity to the state. Patric’s wife Trina was a rising executive at the company. Her next door neighbor Kathleen Atwater was in charge of a marketing group of technical writers. Kathleen came over to meet us. In her kitchen, Kathleen said she was hiring a senior technical writer. I had never been even a junior technical writer. However, my publication record was considerable. I was hired in Patric and Trina’s kitchen and by Thanksgiving a 16 wheel truck had relocating all our family belongings to Durham. It was there I learned about digital transmission and most especially how to switch large data packets (for example, television).

++++

To be continued is the story of how I wound up in the Silicon Valley of California writing about data transmission for a company owned by Indian-born entrepreneurs. What I am planning to tell is how a writer learns about technology and expresses my learning in simple English.

English is a marvelous language especially useful for communicating technology. This post is a roundabout way of appreciating the beauty of our language and how four months before my 70th birthday, I have learned to use English to help women and men in business achieve their objectives.

Between now and the next installment, please feel free to get in touch regarding your language needs. Are you having trouble with a grant proposal, a technical manual, an SEC filing, a speech, a press release, an especially significant email?

Often I do not tell long stories keeping the reader wondering what will happen next. This time I am taking advantage of telling a long story with many installments in the hope that you will read within the lines concepts that may be useful to you.

Until next time, I remain,

–Joel

[email protected]

814-689-9363

http://www.siliconindia.com/profiles/Joel-Solkoff-C5W8MGcL.html

https://joelsolkoff.com/technical-writing-philosophy-sample-availability/

https://joelsolkoff.com/book-store/books/the-politics-of-food/

http://blogs.siliconindia.com/JoelhelpswithbusinessEnglish/

 

Copyright © 2017 by Joel Solkoff. All rights reserved.

Share this:

  • Click to share on Facebook (Opens in new window)
  • Click to share on LinkedIn (Opens in new window)
  • Click to share on Tumblr (Opens in new window)
  • Click to share on Twitter (Opens in new window)
  • Click to print (Opens in new window)
  • Click to email this to a friend (Opens in new window)

Filed Under: Disability and Elderly Issues Tagged With: Clear writing, Grant proposals, Public relations, SEC filings, Silicon India, Silicon India Magazine, Technical writing, Telecommunications

Reader Interactions

Leave a Reply Cancel reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Primary Sidebar

Current

Disability bathroom design

September 3, 2020 By joel

Covid 19 has accelerated the need for a new utilitarian architecture: Architecture for the vulnerable ( like me)

August 19, 2020 By joel

Covid-19 Architects: “We Who Are About to Die Salute You”

August 6, 2020 By joel

Covid 19 impasse: Why architects need to know how a member of the US Congress must be expelled by the end of the month and how that relates to building emergency housing at a time when its absence is deadly and dangerous

July 23, 2020 By joel

John Wayne don't run away

Rain: Butch Cassidy and the Sundance Kid

July 5, 2020 By joel

Theo van Gogh’s The Interview

June 27, 2020 By joel

Recent

  • Ani Ma’Amin: This is what I believe
  • March March from The Chicks: My Personal Anthem
  • 建筑师注意:美国新冠状病毒死亡人数将会激增;你们必须为穷人建造住房
  • I am now a card carrying member of the National Organization for Women
  • God is not on President Trump’s Side; God is on my side
  • The late great James Baldwin on racism in America
  • COVID-19 Updated Information
  • Sensuous Françoise Hardy, Sixties icon, is now 76 years old
  • Mandarin Chinese numbers 1 to 10
  • FOOD: When leading means following the crowd
  • US Representative in Congress Val Demings, Democrat, Florida must be our next Vice President. Must be.
  • Alizée
  • Zimbabwe Last Month: People are dying
  • Make sure the Calgery Stampede is up and running on July first, 2020
  • My Hebrew teacher Mama was born in Louisville Kentucky with the name on her birth certificate:”Muriel Magdalena Pellicia”
  • Cher extremely alive
  • French rock goddess is a protégée of Isadora Duncan
  • Attention Architects: US COVID-19 Deaths Will Skyrocket; You Must Build Housing for the Poor
  • Passover Message to my Fellow Congregants Ohev Sholom, Williamsport PA
  • Perhaps the World Ends Here by The Poet Laureate of the United States
  • My drop dead enthusiastic review of The Meritocracy Trap

Links

Blogroll
  • 1. PHOENIX REHAB1. PHOENIX REHAB With the help of the gifted Alicia Spence, I begin to walk.

  • 2. SMART SPACES FOR INDEPENDENT LIVING2. SMART SPACES FOR INDEPENDENT LIVING "The demographics of baby boomer aging over the next decade foreshadow great economic, political and cultural changes that could overwhelm many developed countries," said Richard Behr, founding director of the Center.

  • 3. IMMERSIVE CONSTRUCTION (ICon) LAB3. IMMERSIVE CONSTRUCTION (ICon) LAB My home in virtual reality, the ICon lab shows 3D and 4D (the fourth dimension is Time) models on 3 eight-foot hight screens; when the lights go off, put on the 3-D glasses.

  • 4. AMIGO MOBILITY4. AMIGO MOBILITY CEO Al Thieme created the first Power Operated Vehicle (POV) scooter. Most manufacturers separate their battery chargers from the scooter. You can plug an Amigo right into an electric socket .

  • 5. T & B MEDICAL5. T & B MEDICAL "Travis and Barb Barr, the 'T' and 'B' behind T & B Medical, Inc. have one goal in mind...to attend to every client's individual" mobility and durable equipment needs. I am a continual customer and recommend T&B highly--HIGHLY.

  • 6. INVACARE6. INVACARE Invacare is the world's leading manufacturer of wheelchairs, bariatric equipment, disability scooters, respiratory products and other homecare products.

  • ACCESSIBILITY FROM APPLEACCESSIBILITY FROM APPLE For the disability community, computer technology creates the ability to engage in computer design of aging-in-place housing.

  • CAREGIVER VILLAGECAREGIVER VILLAGE Using a virtual reality world, Caregiver Village improve the lives of family caregivers. Second Life, eat your heart out.

  • EMAIL MEEMAIL ME I once had a boss who loved focus groups. One afternoon at a shopping mall, readers of my newsletter told me EXACTLY what they thought, not knowing I was behind the one-way mirror. Please do the same.

  • HME NEWSHME NEWS HME News is the monthly business newspaper for 17,000 home medical equipment providers.

  • McKEESPORTMcKEESPORT "The decrease in the population since the 1940s is attributable to the general economic malaise that descended upon the region when the steelmaking industry moved elsewhere. The major employer WAS the National Tube Works, a manufacturer of steel pipes.

  • MONONGAHELA RIVERMONONGAHELA RIVER George Washington crossed the Monongahela into McKeesport to bring rum to the his friend, Queen Alliquippa, a Seneca Indian ruler. This was during the French and Indian Wars, Remember them?

  • NATIONAL FEDERATION OF THE BLIND

  • PENNSYLVANIA ASSOCIATION OF REHABILITATION FACILITIES (PARF)PENNSYLVANIA ASSOCIATION OF REHABILITATION FACILITIES (PARF) PARF represents the Commonwealth's premier facilities serving individuals with physical, mental, and emotional disabilities. Traditionally, the highlight of the disability community is the annual conference at the Nittany Lion Inn at the Penn State campus

  • YOUGHIOGHENY RIVERYOUGHIOGHENY RIVER McKeesport is where the Youghiogheny and Monongahela Rivers meet. Fresh fish like the Walleye are back at the Youghiogheny, now that factories that created jobs are no longer polluting the river.

Previous Posts

Tags

Addison Court Amelia Altalena Solkoff Amelia Solkoff Amigo Mobility Architectural Engineering assistive technology blind Blueroof Technologies cancer Central Pennsylvania Centre County design featured-grid Helen Keller HME News Isadore Solkoff Joanna Joanna Solkoff Joel Solkoff John Bertoty John Messner kidney cancer McKeesport Medicaid Medicare Memorial Sloan Kettering Cancer Center Miriam Pell Schmerler Miss Sullivan New York City North Carolina PA Penn State Pennsylvania power chairs President Obama Robert Walters Sarah Schmerler scooter Sonali Kumar Spain State College United States University Park Virtual reality Wikipedia

Footer

Recent

  • 1971 birthday letter to my father
  • If by Rudyard Kipling
  • Grandfather (that’s me) relocating to NYC to save my life at Memorial Sloan Kettering Cancer Center
  • Why I relate ending hunger in US America to writing about my cancer survival for The New York Times
  • My love hate relationship with The New York Times 2018
  • Radio hate monger of the 1930s Father Coughlin returns to Fox News
  • A fine romance with no kisses
  • The US Needs a New Capitol City: Covid Agenda Item
  • The US Election & Housing for the Vulnerable
  • We who are about to die…or architecture

Subscribe

Enter your email address to subscribe to this blog and receive notifications of new posts by email.

Join 50 other subscribers

Cart

Copyright © 2021 · Magazine Pro on Genesis Framework · WordPress · Log in

loading Cancel
Post was not sent - check your email addresses!
Email check failed, please try again
Sorry, your blog cannot share posts by email.