Two Ways to Chunk Content with MadCap Flare

Mike Hamilton on the MadCap blog wrote an excellent tutorial on how to chunk content. We’ve covered this subject before, especially when looking at information architecture and how to write for the web. What’s interesting about Mike’s article is how he uses conditional markers to do this in MadCap Flare.

Sample Guidelines for Writing Online Help

If you’re looking for guidelines to write your online help documentation, then use this checklist to get started.

9 Ways To Peer Review Technical Documents

I’ve always had mixed feelings about peer reviews. What they’re done right, we all learn but like Lesson Learned review can easily degenerate into bitching sessions if not managed correctly.

Lessons Learned from Collaborative Writing Projects

We make mistakes every week on our Technical Writing projects. However, since we’ve started to capture things in our lessons learned meetings, the ‘repeat offenders’ have gone down. Running web-based Technical Writing projects is difficult as you don’t get to meet the team you’re managing, so sessions like this can make a real difference.

How Apple’s Setup Guides Thinks Different

Seth Godin believes that everything reflects what you stand for—right down to your technical documents. Ever looked at Apple’s tech docs? How Apple’s Setup Guides Shows it Thinks Different Looking for inspiration? Well, this puppy has been looking for inspiration recently. I’m writing a series of Setup Guides and wanted to see how others approach […]

How To Develop a Capacity Plan

Developing a Capacity Plan is vital if you want to understand how much capacity will be required to support your IT systems and, by extension, the infrastructure that supports it. Think about it. If you plan to install a new large-scale solution, for example, IBM WebSphere or SAP, you also need to consider the impact […]