DEV Community

Cover image for My First Three Months As A Technical Writer
Maddy
Maddy

Posted on • Originally published at techwithmaddy.com on

My First Three Months As A Technical Writer

This year I quit software engineering to go into technical writing full-time.

This article will describe my first three months as a technical writer.

Let's start.

Communication is key

Communication is one of a technical writer's strengths.

Communication is not just how you communicate technical information to your user.

Communication is also:

  • How you communicate with members of your team.

  • How you communicate with colleagues outside of your immediate team.

  • How to make a request to get the desired outcome.

  • How to communicate in a way that is direct and kind simultaneously.

Stakeholder management is a skill

Stakeholder management is the process of maintaining good relationships with the people who have most impact on your work.[MindTools]

A stakeholder is anyone who can be affected by the outcome of a project.

In a software project, stakeholders are usually product managers, project managers, and directors.

Stakeholder management involves:

  • Identifying the strategy to communicate with stakeholders.

  • Recognizing the influence a stakeholder has on a project.

  • Following the stakeholder's strategy.

User experience is a skill

Everything that involves people interacting with something is a part of the user experience.[Technical Writing as a Part of User Experience]

Technical writers are critical to a product's success. As a technical writer, it's essential to acknowledge what the users need to understand and use, document, and write about a product.

You're constantly learning

Software engineers constantly learn, and so do technical writers.

Technical writers learn something new every day.

You learn the company's style guide, the company's products, the technology behind the products, etc.

Read How To Transition From Software Engineer to Technical Writer

Writing is 20% of the job

Although "writing" is part of the job title, technical writing also involves:

  • Editing and proofreading.

  • Project management.

  • Reading and researching.

  • Managing and planning meetings.

Read 3 Things You Can Do To Improve Your Technical Writing Skills

Cross-functional collaboration is part of the job

Technical writing can be perceived as a lonely job, but I find this to be far from the truth.

Technical writing involves a lot of cross-functional collaboration with other colleagues, engineers, product managers, and UX designers.

Technical writers seek help from various teams to produce compelling documentation.

Technical writers need multiple and different perspectives to create documentation that users will find easy to read.

Key Takeaways

My first three months as a technical writer have been full of learning. I do not regret making the transition.

Technical writing is a job that develops your communication skill and teaches you how to build relationships with other people.

If you enjoyed this article, subscribe to my FREE weekly newsletter. I share more content like this.

Until next time!

Top comments (0)