When I left academia to become a technical writer in the software industry, I thought I had it all figured out. After all, I’d been a professor, a researcher, someone who could dive deep into complex ideas and explain them to a room full of students. I also had written in tech blogs for over a decade! How different could technical writing be?… (read the rest)
Hiring a technical writer isn’t just about finding someone who can write well. You need someone who can navigate technical complexity, collaborate with engineers, and bring clarity to the chaos of development processes. It’s about finding a curious, resourceful problem-solver who thrives in ambiguity.
Over my career, I’ve conducted more than 70 interviews for technical writing roles. My very first interview?
If there’s one thing I’ve learned as a technical writer, it’s that asking good questions can make or break your documentation. Subject matter experts (SMEs) are often your gateway to understanding the intricacies of a product, feature, or system. But let’s be honest—getting information from SMEs isn’t always straightforward.
They’re busy, they might not know how to explain things to non-experts, or sometimes they just forget we’re not telepathic.… (read the rest)
/Like it or not, a project management mindset can get you to your next level in your technical writing career.
When people think about technical writing, they often imagine someone immersed in markdown files, fiddling with APIs, and even dabbling in a bit of code. (Or maybe that’s how I want people to think about me.)
And while those skills are helpful, there is one under-mentioned superpower of a technical writer that almost no one talks about: project management.… (read the rest)
I’m giving a talk on the upcoming DevFest Munich 2023, organized by the Google Developers Group in Munich. It’s a 1-day tech that will offer tech talks, workshops, and opportunities to meet people in the industry.
In my case, I wanted to talk about documentation in a relatable way. That’s why my talk is called Just document it: Minimum Viable Documentation.… (read the rest)
Technical writers often face the challenge of creating complex technical content that is both accurate and engaging. Using personas can help technical writers overcome this challenge by providing a clear target audience.
In user experience (UX) design, personas are fictional characters representing the different types of users who might use a product or service. These personas are based on user research and are designed to help designers and other stakeholders understand the needs, goals, and behaviors of the different types of users.… (read the rest)
Release notes are the way we let users know about changes in our application or service.
Unfortunately, users and developers often ignore them, and tech writers consider them one of the most boring types of technical documentation. So, obviously, I wanted to talk about them.
Something to get out of the way before starting is the usage of the term. We use release notes when you have different versions of a software or application.… (read the rest)
I started my career as a Tech Writer in my thirties, and I felt I needed to pick up the pace and step up my tech writing game. And I needed to do it fast.
Coming from Academia, I did the only thing I knew was a shortcut to knowledge: studying.
I asked my manager and other experienced technical writers in my team for books about technical writing, specifically technical writing for software and API documentation.… (read the rest)
I’ve been a writer of sorts for around ten years. I love writing, and I consider it almost second nature to me.
Whenever I want to share something, create something, or do something, I start by writing.
And now I get to do it for a living, which I love. But every time I have to tell someone what I do for a living, I always receive weird looks.… (read the rest)
This blog is inspired by many other technical writing blogs, such as I’d Rather Be Writing by Tom Johnson and Passo Uno by Fabrizio Ferri Benedetti.
What made me start was a blog post and Twitter thread by Fabrizio, talking about needing more technical writing content out there. I loved how, in my previous company, I could mentor new tech writers and teach them about the trade.… (read the rest)