Post a note under our blog aggregation requests if you want your blog added to our aggregator. Please provide the RSS feed URL and the title of your blog.
I’ll be speaking at the lunchtime meeting of the Sydney CBD Technical Writers’ Group on Wednesday 6th August. This group is led by Bede Sunter on behalf of the Australian Society for Technical Communication NSW. The session is free of charge, and open to all. You’re invited! (Please bring your own lunch.)
The talk is titled, “API Technical Writing: What, Why, and How“.
Have you ever wondered what API technical writers do, and how they go about it? Perhaps you’d like to move into developer-focused documentation yourself, and need some tips (more)
Lately I have been exploring different ways to let subject matter experts review DITA content. In a previous post, I explored using easyDITA to facilitate the review. In this post, I’ll explore OxygenXML’s Webhelp with Feedback output for conducting the reviews.What makes for a good review process?
By far the best review method I’ve (more)
Next week, Displaced Persons, a graphic novel by Derek McCulloch and Anthony Peruzzo hits the comic stores, with general release later in the month. I mentioned earlier in the month that you could look at a preview of book online. Now you can read a long interview with the author (Derek) and artist (Anthony).
I’m really excited that this book is finally coming out. I was an advance re (more)
My DITA quick reference guide, or DITA QRG, is available on my menu bar and here: http://idratherbewriting.com/ditaqrg/. This DITA QRG consists of my own notes for working with DITA.
MIF2GO, the fine FrameMaker plug-in to cnvert FrameMaker to Word, is now free and open source following the death of OmniSys founder Jeremy Griffiths. This was posted on several mailing lists today by Carolyn Stallard:
FrameMaker plug-in Mif2Go is available for download, at no charge:
Join the new Mif2Go list:
DITA2Go is available for download:
Join the new (more)
How can you implement DITA content strategy? Is DITA itself a content strategy? The answer is a resounding no. DITA is an architecture. DITA and content strategy are related, but “we use DITA” is not a content strategy. The content strategy process goes … Continue reading →
I don’t often review fiction on this site because I made a decision long ago to brand this site as being specifically about tech comm. But a couple of recent posts by my blogging friends (Neil Kaplan and Sarah Maddox) remind me that it’s good to show more than one side of a person. I wouldn’t want you to thin (more)
Hallo fellow techcomm folks! Do you have a hobby?
Mine is fairly pedestrian. I like to go walking in the bush. It blows away the cobwebs. Well, actually, I often have to blow away the cobwebs myself. They festoon the pathways in the early morning. It’s best to keep your mouth closed when strolling in the Australian bush, or you’ll find yourself spitting spiders.
Sometimes a bird pops out and does something interesting, and I (more)
Since moving to DITA, I’ve tried to settle on best practices and determine the authoring method that works best for me. I started out using OxygenXML, which is one of the most popular DITA editors. I like OxygenXML because it’s easy to work with the code. OxygenXML knows when to show you a list of all possible elements or values you can insert in your topic at any time.
For example, if you type <note type=", the editor prompts you with values you can choose from.(more)
If you’re at all interested in language, or in English, then you already know that words change meaning. And not only do they change meaning, but sometimes they’re coined to mean something other than what you might expect. For example, if someone calls you a “mouth-breather,” then you should know that you’re being insulted. I’m sorry to be the one to tell you, but someone thinks that you’re stupid.
Now, there are probably extremely bright people who momentar (more)
Your content strategy is approved. Your tools are in place. Now it’s time to crank up—your pilot project, that is. Consider these tips when mapping out your content strategy pilot project. Your pilot project is a proof of concept—not perfection … Continue reading →