⚠️ Warning:
For this post we are exploring when and how to use notes, warnings, and callouts in technical writing.
Truth is that writing callouts can be an art, and is good to follow some guidelines. So I decided to write these mostly for me, because I think is something most writers can improve on.
https://bufferbuffer.com/when-to-use-notes-warnings-and-callouts-in-tech-writing-and-when-not-to/
When to use notes, warnings, and callouts in tech writing (and when not to) – BufferBuffer
Learn how small docs can improve your technical writing process. I try to cover everything from how they can help get quicker reviews to how they help achieve better collaboration.
Check it out:
https://bufferbuffer.com/why-writing-small-docs-is-a-game-changer/
Why writing small docs is a game changer – BufferBuffer
Good thing that, at least, we are gonna have a new Nintendo Switch and, probably, a new Animal Crossing.
I never imagined that I would be alive in a technofeudalist eco-dystopian future powered by AI. Yet, here we are.
Sometimes I feel that Germans believe that it is more important to do nothing "wrong" (according to some arbitrary rule that someone faxed someone else forty years ago) than it is to do something right.
And, does it even make sense to build a following again? I remember how it was in the Twitter era, and I grew mostly because I felt I was connecting with other people, but also because of my work in tech journalism and jumping on every 'funny' trend.
It's funny how I don't know which social media account to favor over any other. Right now I have Threads, Bluesky, and Mastodon in the "microblogging" space.
I have more followers in Threads, but audiences barely overlap. And if I were to choose, I would probably invest more time and effort in growing an audience in Mastodon (because of it's open nature).
I started in technical writing almost 7 years ago. And I thank Meeta, my first manager, and my team for helping me figure out these lessons. The 10 things I learned the hard way about tech writing.
https://bufferbuffer.com/10-things-i-learned-the-hard-way-about-technical-writing-in-tech/
10 things I learned the hard way about technical writing in tech – BufferBuffer
Is this my idea or is it just an hallucination of the LLM in my head?