Blog Archives

Moved to www.techwritingengineer.com

The blog has moved to www.techwritingengineer.com Advertisements

Posted in Uncategorized

Convert CSV-data to XML-files

Here’s a tool I developed that transforms CSV-data into XML-data based on a template. You can use it to, for example: Create MadCap Flare snippet files Create topic files Create MadCap Flare target files Create MadCap Flare condition sets Create

Tagged with: , , , , , , ,
Posted in Automation, Excel, Uncategorized

How to fold an origami crane

Origami crane.

As a kid I wanted to learn how to do origami. It was pure magic to see someone take a square piece of paper and turn it into a bird, a frog, or even an elephant. I decided to give

Tagged with: , ,
Posted in Origami, Technical communication

Setting up a Kanban Board in MadCap Flare

If you’re a fan of using Kanban boards – the simplest way of implementing one in MadCap Flare is to use a TOC.  Setting up a Kanban TOC in Flare Create a new TOC and add items corresponding to your workflow (e.g.

Posted in Agile, Automation, Kanban, Lean, MadCap Flare

Generate a MadCap Flare TOC from Excel using VBA

When you are crafting a content specification table of contents, you might want to first  “brainstorm” a TOC using Excel, and then simply export the structure to Flare once you’re done. You can write a short VBA function that does

Tagged with: , , , , ,
Posted in Excel, MadCap Flare

Customer specific documentation with MadCap Flare

Are you documenting a product that consists of a bunch of modules? Do customers buy customized products with a unique set of modules? Would you like to deliver customer-specific documentation using MadCap Flare? Keep reading. The idea is to use

Tagged with: ,
Posted in Excel, MadCap Flare

How to add wiki-words to your HTML5 output in MadCap Flare

Would you like to link certain words or phrases to your internal wiki, or perhaps to Wikipedia? Would you like to build your output only once, but still be able differentiate between “internal” and “external” audiences? Keep reading. The idea

Posted in Javascript, MadCap Flare

Adding a feedback button to your Flare HTML5 output

Are you looking for instructions on how to add an e-mail feedback button to the toolbar of your MadCap Flare HTML5 output? And would you like a copy of the relevant URL included in the e-mails you get? Keep reading.

Tagged with: , , ,
Posted in Javascript, MadCap Flare

Keeping track of your Flare topics in Excel using pivot charts

If you are using file tags to keep track of your topics in Flare (e.g. 01 Created, … , 06 Published), and if you need a way to get a quick visual overview of all your files, keep reading. Keeping

Tagged with: , , , , ,
Posted in Excel, MadCap Flare

The benefits of working with small batches

I just read The Lean Startup by Eric Reis, and found that the Build – Measure – Learn cycle can easily be adopted in technical writing. The idea is to build (design, and write), then measure (SME reviews, editor comments),

Tagged with: , ,
Posted in Technical communication