Category Archives: Advice

Romancing the RoboHelp

In my latest project, I’ve been reacquainting myself with the joys of Adobe RoboHelp and Framemaker to produce some online help. Please see my previous post about RoboHelp that I’ve updated to include RoboHelp 11. I’ve been using RoboHelp for … Continue reading

Posted in Advice, Projects, Technology | Tagged , | Leave a comment

Writing and Editing

Writing is like building a house in the woods where no house previously existed. Re-writing is like demolishing a house in the woods and rebuilding it to suit your needs and stylish flair. Editing is like: inspecting every door and … Continue reading

Posted in Advice, Fun, Writing | Tagged , , | Leave a comment

Strengthen Your Writing

Reading technical documentation is nobody’s idea of an enjoyable night in. You could try to make it special with some wine and candlelight, but it’s still going to be a stretch. Therefore, the documentation needs to strike that balance between … Continue reading

Posted in Advice, Writing | Tagged , | Leave a comment

Fixing the Giant Ship

I was looking up some stories and I came across this Islamic folktale: – The following is an incident about an engine failure in a giant ship. The ship’s owners tried one expert after another, but none of them could … Continue reading

Posted in Advice, Writing | Leave a comment

Professional Body Language

When you are working with people, either as a co-worker or as a manager, and you have someone explaining something to you that either you don’t understand or you think is outlandish, you need to hide these emotions from your … Continue reading

Posted in Advice | Tagged | Leave a comment

Random Advice

Just in case any of you go crazy and decide to be Technical Writers, let me impart this nugget of wisdom: when writing instructions, be aware that users PRESS keys on a keyboard and they CLICK buttons on the interface. … Continue reading

Posted in Advice | Tagged | Leave a comment

Pictures vs Words

I submitted a sample draft of a User Guide to my client a few days ago and I got the feedback today. Most of it was fine, but this one comment made my left eye twitch: Is there a way … Continue reading

Posted in Advice | Tagged , | Leave a comment

Creating Topics in Robohelp from a Frame document

I’m currently relearning the joys of RoboHelp after a few years and a few versions of unfamiliarity and I hit a snag on trying to convert documents into topics. I’m using Framemaker 10 and RoboHelp 9 (as part of the … Continue reading

Posted in Advice, Technology | Tagged , | 2 Comments

Blueberry Perception of Techwriters

Last week, my 7 year-old Toshibasaurus finally broke down (actually, it was the battery and power pack that died). I could just replace the battery/power pack, but truth be told, the Toshibasaurus was getting long in the tooth and slow … Continue reading

Posted in Advice, My Gadgets | Tagged | Leave a comment

Navigating DOS menus

I keep discovering that the ExoPC is better designed than I previously believed. Because it’s a Windows OS, it sometimes doesn’t shut-down properly and when you boot it up again, you get a text-based DOS menu asking you to take … Continue reading

Posted in Advice, My Gadgets, Technology | Tagged , | Leave a comment