Welcome to my new technical writing blog.

First, a big shout out to the following thought leaders who have encouraged more technical writers to share their knowledge and opinions.

• Fabrizio Ferri Benedetti
  • Terrific human whose blog posts stir conversations and help us build a better vocabulary for what we do.
  • Technical writing has a depth issue is a powerful call to action for more of us to step out of the shadows and own our expertise.
• Not-Boring Tech Writer Podcast
  • In particular, The craft of technical writing with Marcia Riefer Johnston talks about the snowballing power of sharing a small tidbit of information and then building on it.
• Write the Docs Slack
  • Write the Docs is a global community of people who care about documentation.
  • The Slack channel contains a lot of expertise. It's been great to hear all the different voices and it is why I went to my first Write the Docs conference.
• Write the Docs, Portland (USA)
  • A wonderful annual conference for documentarians (be they technical writers, programmers, managers, project managers, user support agents or wild enthusiasts).
  • At the conference this year (2025) I shared multiple frameworks with folks and gave a Lightning Talk. These topics will form the basis of my initial blog posts.

Over the coming weeks I'll share various tools and tricks for analysing your docs and getting insights into your users and products. I'll also share some resources for a more holistic approach to the work we do. When we think about content quality, we often focus on the docs themselves, when workplace environments and physical humans need just as much attention.

If you have thoughts, feedback or ideas you'd like me to expand on, you can email me at liz@lizargall.com or create an issue in the GitHub repository of this website. If issues ever need to be moderated I'll use the Write the Docs Code of Conduct as the framework, AKA don't be a jerk.

If you use any of my ideas and would like to share how they're going for you, I'd love to hear from you as well.

Thanks to my fellow documentarians, you make it a pleasure to write for.

If you'd like to get an email every time there's a blog post, subscribe to my technical writing mailing list.

Good things,

Liz

liz@lizargall.com

11 May 2025