MadCap Flare: Conditional Text 101

Conditional text is one of those writing tactics technical writers love to talk about… but never seem to use. It’s a shame as conditional tagging can save you a lot of time, especially if you have technical documents which share 90% of the content but the other 10% needs to be tweaked for each release. […]

How to Write Error Messages: Faster, Stronger, Better

Blame the cat, TV, or the neighbors if you want. The thing is: stuff happens. When it does, you need some way to fix it, pronto. Aren’t  I right? This is where error messages can save you bacon. No one thinks of writing an error message guide until it’s too late. So, I’m telling you […]

How Advertising in User Guides Could Work

Putting advertising in user guides may seem rather flaky at first, but it could work. Here’s why. Life is full of taboos. Things you should and shouldn’t do. One of my ‘pet projects’ is to connect the lines between Sales and Technical Documentation. To me, they both serve the same purpose. Serve the customer. While they both start at different points, the end goal is the same. Unfortunately, these two departments rarely work together. Let’s take a look at how we can fix this.