The technical writer’s 5 best friends

drew-farwell-481120-unsplash
Technical writers need to expand their personal and professional friends because they need to. Building a strong personal and professional network
1. The product manager
The product manager can be the technical writer’s best friend or worst enemy. Knowing a competent product manager can aid technical writers to better understand the product they are documenting.
On the dark side, when faced with incompetent product management, a technical writer with their grounding in writing product requirements and functional specifications can help be a voice of reason during the triage of ambiguous or plain technically unfeasible requirements.
2. The senior DBA/database architect
The whole world and many of today’s leading-edge web applications run on databases making a senior DBA and database architect a valuable friend indeed.
3, The storage area network engineer
Let’s face it all the business world’s data (and secrets) live on one SAN or another.
4, The financial controller
It never hurts to know the person who handles the money and processes the checks. This is true for employees not just freelancers and independent contractors.
5. The solution architect
Solution architects and network architects can be valuable friends of the technical writer because of their responsibilities over the design of solutions.
Who are your five best friends as a technical writer?

 

Photo by Drew Farwell on Unsplash

A lesson I learned as a contract technical writer

daria-nepriakhina-21925-unsplash
As a favor to an old friend,  I spoke to one of their friend’s kids who got laid off and was forced to go into contract IT work so they could keep paying the bills.

Here is one question and answer that stuck out from our phone call:

Them: What do you find true about contracting?

Me: The very people who will criticize you for the tiniest mistake will be the same people who take credit for your successes and good ideas after your contract gig ends.

Unfortunately, depending on the organization, it happens to full-time employees too.

Weird things I saw when I was a contract technical writer

alex-kotliarskyi-361081-unsplashI’ve been out of full-time contracting for almost two years and recently thought back to some of the stranger things I saw during the contract technical writer chapter of my life:

  • A fellow contractor was posting nude pictures of his wife on Usenet from his client account. He was busted and walked offsite by armed security guards when a Usenet reader emailed the Webmaster of the client’s domain.
  • A client who demanded the word, Please be used to begin every procedure in a user guide.
  • Contract agency recruiters who just told so many obvious lies I wondered if their nose grew. There should be a special place in hell for unethical contract agency recruiters.
  • A contractor who got sick and went AWOL while on a business trip to NYC. The contracting agency had to evict her from her hotel room. After taking over her hotel room, I could understand how she would want to lay in bed all day in that hotel.
  • A contractor who inflated their resume so much it made me see the problems that swept along technical writers and swept along trainers cause for real professionals.
  • A contractor who quit via email the Sunday evening before leaving Monday on a trip to Los Angeles. He knew the whole time he was going to stop. While I understand At-Will Employment cuts both ways, there is professionalism and decency.

Once upon a time, contractors could always count on other contractors. I stayed too long at the party. The contracting market I entered was not the same one I left.

What weird things did you see as a contract technical writer?

Photo by Alex Kotliarskyi on Unsplash

Reflections on my technical writing career

pablo-garcia-saldana-94058-unsplash

I was once asked in a job interview: “Why do I stay a technical writer when it must be such a dull and boring profession?”  After the meeting when I was peeling rubber out of the parking lot, I took a few moments when I was decelerating to think about some of the more interesting moments (at least to me) from my career:

Continue reading →

Learning new software: A personal retrospective

michal-kubalczyk-505207-unsplash

When I was in college, I took an on-campus job in my college’s computer lab that I still consider to this day to be a very formative experience. The director of the computer lab helped me discover the technology chops that I still carry me to this day. He had a penchant for scouting student employees from non-technical and liberal arts areas of study like English, Education, and Psychology. He is one of the only people in my academic and professional past I call a mentor. When I found a home working with technology, I gave up my goal of becoming a journalist for becoming a technical writer. College was tough because of my dyslexia, but my job in the computer lab charted a new course for me that I am still following today.

Continue reading →

Simple guidelines for running technical document reviews remotely

simon-abrams-286276
With some clear expectations and a little planning upfront, running remote writing and document review projects can go smoothlyHere are some lessons I learned when I was a freelancer about running remote writing and editing projects:

Continue reading →

The 7 deadly sins of project leadership

fabian-blank-67318

Project team leadership is an even more important skill in today’s tight economic times making it even more of a shame when new, and even some experienced project leads fumble the ball in the name of their muddled agendas.

While doing more with less is quite a mantra these days, there are seven deadly sins of project leadership holding back once successful project teams from continuing to thrive.

Continue reading →