After years of grumpily editing old content, I’ve found that many writers – including myself – have a problem meeting the reader’s needs. The average reader needs a concrete outcome like following a process or learning a new concept. Usually, the overall structure of the content matches that need; technical writers have a sort of […]
In no particular order, here are my recommendations for writing samples for those of you applying for a tech writing job. And yes, you need writing samples. Purpose The purpose of writing samples is to prove you have technical writing skills, not that you’ve held down a job. So when you pick or write samples, […]
Toggle between two versions of each paragraph to see what readable English looks like.
Gowri Ramkumar at Knowledgebase Ninjas gave me the opportunity to participate in my first ever podcast and talk about my experience in technical writing and the direction Unity Documentation is going. Listen to the episode on their website.
You know that moment in the shower when you suddenly get an excellent idea? That happens when your brain, working away quietly while you’re talking to yourself about what could possibly have compelled you to buy shower gel that smells like a food item, suddenly connects two dots. We say that things just clicked, or […]
Hiring’s hard, and the cost of getting it wrong can be fairly high. Sometimes new employees will do harm; often they just won’t do as much good as the candidates you didn’t hire. So here are three questions to ask about a candidate that may help you make the best hiring choice. Do they bring […]
So here we are, at the end of our attention span, and I guess it’s time to address the elephant in the room: productivity. I’m not a huge fan of productivity talk. It always feels rushed, stressful, and focused on quantity over quality. Focusing on attention feels like the exact opposite: The goal is to […]
Research notes. A bombastic name for what is usually a bunch of half formed thoughts and snatches of typos. But you know what I mean. Why am I talking about research notes? Because, at least for me, messy notes – especially if they’re physically scattered among multiple sources (notebook, bits of paper, several different files) […]
Until now, we’ve focused on calming the chaos of our internal voice. Now it’s time we talked about that other attention killer: external voices. And, because I like to cheat, their influence on our internal voice. One thing you can do this week: Understand the difference between objective obligations and emotions. Nothing new here Honestly, […]
We tend to focus on planing one day at a time. And sure, we need to look at our plan in the morning (or the previous evening) and tidy it up. But we should also plan each week , either on Monday morning or, if you like spoiling your weekend, on Sunday evening. Some people […]