About

I'm Fabrizio Ferri Benedetti, a technical and UX writer based in Barcelona, Spain (more)


Latest posts

Nov. 7, 2022

How to become a technical writer - Part I

Every now and then, people ask me how one can become a technical writer for software companies. Answering that question has always been difficult, as there is no clear career path for becoming a tech writer, nor a demand for tech writers such that it’d push formal tech comms education forward (at least in Europe). While the role has grown in popularity, technical writers are still a small fraction of the total workforce in the tech industry. The question is so powerful, though, that I cannot ignore it. I’ll try to provide an answer.

Oct. 30, 2022

Learning to code as a technical writer

A recurring question from people entering the tech writing profession is “Should I learn to code?”. This query has become hugely popular in the docs-as-code age, where writers and developers live in the same DevOps trenches, eating the same CI/CD rations and publishing docs using broken tools that often lack maintainers.

My answer is “These are not the learnings you’re looking for.”

Oct. 14, 2022

My first children’s book is about... OpenTelemetry

Almost a year ago I had this crazy idea of writing a children’s book on OpenTelemetry. In this, I was inspired not only by my lifelong love for illustrated stories, but also by the example set by Gently Down the Stream, a children’s story on Apache Kafka. I pitched the idea around a bit, processed some feedback, then got down to it. Now the book is online!

Sep. 19, 2022

Circles of Product Truth

While thinking about unconventional technical communication, like comic books, children stories, and games, a thought occurred to me that they’re all attempts at hitting the core of what a product is and does, that is, its truth. I developed this picture of a series of concentric levels of comprehension and something resembling the circles of Dante’s Inferno came out of it. Don’t run away yet: Embrace hope all ye who enter here.

Aug. 28, 2022

Docs Hierarchy of Priorities: A Proposal

As a psychologist, I’m quite familiar with Maslow’s hierarchy of needs. It’s an extremely popular framework for human motivation. The hierarchy, often pictured as a pyramid, states that people look for certain things following a certain order: First shelter, then food, then company, etc. As with most psychological theories, Maslow’s is almost certainly false; nonetheless, it provides a very intuitive way of thinking about priorities.

Aug. 11, 2022

Tech Writing Skills Tree

I had lots of fun creating this D&D style skills tree for technical writers. I made this one out of the belief that there are multiple ways of becoming a tech writer, and that tech writers can specialize.

Aug. 6, 2022

Measure it till you make it

There’s a string of questions that haunt every technical writer and documentation manager at some point in their careers: How do we know that we’ve done a good job? Have we been successful given our limited resources? How can we get better at what we do? Are the docs nailing it? How can we measure value? What do we tell upper management? More importantly, will we know what we’re saying when presenting those figures in slides? And, can you point me to the nearest emergency exit?

Jul. 18, 2022

A love letter to technical writing

I wanted to write this post for a long time, but got to it only now, perhaps because it’s a natural segue into Let’s blog more about technical writing. Whatever the reason, I’m in a moment of my life where I feel compelled to say out loud why I love technical writing. Perhaps you’ll find some words of inspiration here. Or maybe not.

Jul. 15, 2022

Let's blog more about technical writing

I’ve been wondering for a while why I don’t see more blogs on technical writing, tech comms, and technical documentation. I’ve been in listening mode for years, and beyond Tom Johnson’s excellent blog, it’s hard to find more content around technical writing. I’ve some hypotheses as to why that’s happening, as well as a request: We should be blogging more about technical writing and tech comms.

Jul. 3, 2022

How to introduce prose linters at your workplace

Prose linters are great at checking documentation against style guides, either in code editors or when running a CI/CD pipeline. They can capture issues in your docs that might have been overlooked by reviewers, thus avoiding costly mistakes. The bigger problem is how to bring the value of linters to our day-to-day jobs. How do you persuade colleagues to use them when drafting docs? It takes a little patience and ingenuity.

Read more blog posts in /posts.