Monday , 22 December 2014

Category Archives: Blog

Making it Easier to Convert Flare TOCs into HTML

Did you know that there is a way to convert the TOC in Flare into a regular HTML list? It is something I discovered on the MadCap Flare forums, in a post by Dave Lee. There, he explained that you can use an XML transformation to turn Flare’s regular TOC file into a bog-standard HTML UL list. If you are… Read More »

“Technical Writing’s Dead, Get into E-Learning”

“I can’t believe you are still doing that. Technical writing’s dead, get into e-learning.” Not my words, but the words of a former technical writer who moved on to work in information design. Usually, comments like this are like water off a duck’s back, but this time something jarred with me. So I decided to ask some learning professionals about… Read More »

Technical Writing Tools – Do You Need to Know Every Tool?

Have you ever felt yourself becoming overwhelmed with the amount of things you need to learn? Join the club. Since quitting the day job as an employed technical writer and trying my hand at contracting, I’ve been compelled to learn more about a variety of Help Authoring Tools and technical communication principles, ideas, etc.  Like an idiot, I’ve tried to… Read More »

A Process for Technical Documentation

When you’ve been a technical author for many years, the process of creating technical communication becomes second-nature. So when a client asked me to draw up a technical communication process, I had to think carefully about each step of the process. Of course, it can vary depending on the organisation, but on the whole, the process I work to is… Read More »

5 Key Benefits of Topic-Based Documentation

Taking a topic-based approach to your documentation can improve the quality of your manuals and online help, reduce your documentation costs, and make it easier for your writers to produce and update content. This approach is not new, but implementing it with the latest authoring tools, such as Flare, Robohelp, Confluence or a DITA editor like oXygen, does give you… Read More »