What Macaulay Culkin Can Teach You About Technical Writing

Larry says that last week another technical writer asserted that DITA has “jumped the shark.” “It’s not a new idea. I’ve heard other people say that DITA has already seen its best days, that it’s struggling to remain relevant in a world that’s passed it by. I was amused, I admit, because it was the first time I’d seen DITA compared to a TV show.”

Janet Swisher on FLOSS Manuals, Open Source, and Book Sprints

Want to know how to run an open source ‘book sprint’? Janet Swisher does.

What are Your Favorite 10 Technical Writing Tools?

I’ve used the same technical writing tools for the last 5 years. A few products have come across my desk but nothing that really blown me away. Here’s a run-down of what I use to write my technical documents. No order of preference. Which should I keep? Which should I replace?

Review of DITA Authoring Software

Of all the technical writing tools I’ve used over the years, Epic Editor was probably the most impressive, especially when it came to doing tech documents that involved DocBook and Dita. It was difficult to learn – no point pretending otherwise – but once I got the hang of it, I used it non-stop for […]

Why Table of Contents Don’t Display in MS Word

In Word, the Table of Contents is not displayed. Instead, I get an error message: { TOCO “2-4″H Z T “HEADING 1,1”} Ivan – I think the problem is to do with Field Codes, so here’s a few suggestions. 1. In Word, go to Tools > Options > View tab and click off Field Codes […]

Age Discrimination in the IT Industry?

I receive about 20 CVs every month from writers looking to either supplement their income as freelancers or look for new opportunities in the tech writing field.   A common thread among many of these letters is from individuals who are finding it increasingly difficult to increase their earnings once they get over 40. Their […]