There is a line in Atomic Habits that I really like: “I’m just proactively lazy. It gives you so much time back”. It refers to resetting a room after every use so that it’s ready the next time you want to use it. I like to apply it to my work computer, and I am […]
When breaking a large project into tasks, there are better and worse ways to go about it. A pretty bad start is picking tasks that are the wrong size – they’re still too big, and require further breakdown. So what’s a good size for a task, and how can your own description of a task […]
Recommended reading for you today: Anatomy of an editing comment.
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 […]
That dreadful moment (hour? day?) when the words won’t come. We think of writer’s block as something that is stopping a well formed image from settling into the right words. But in reality, a writer’s block happens when our mental image is a little hazy and abstract. We can’t put it into words because words […]
In a conversation about your user’s needs, it’s natural to start throwing out solutions almost immediately. Someone brings up an aspect of the user’s needs, and someone knows how to answer that aspect. But suddenly, that one aspect is all you’re talking about. You’ve just blinkered your view of the user to whatever can be […]
Writing begins with awareness of the single word, then moves up. What can a word mean, and what does it actually mean in its current context? Does the sentence make its point as clearly as possible? Does the paragraph come together as a single point? Is it in the right place Does the whole document tell […]
As a technical writer, one of the most important questions you can ask yourself is “what are the default values of the choices a user can make, and why”. For example, if an option is disabled by default, what does that tell you about the average user and their workflow? Are you trying to protect […]
If you’re working on a product and have no particular understanding of UX, you can still do a basic UX review to stop the most obvious disasters. This will not be as good as getting a UX expert or experienced UX-QA to review the product, but it will be much better than nothing.
Here’s a quick writing tip for user manuals: don’t add your images to the manual until you’re done writing your text. This has two advantages. The first is that when you add images one at a time over the long course of writing a manual, it’s easy to overdo it. When you add them all […]
Tested Writing 
You must be logged in to post a comment.