Author in DITA, publish with WordPress

wordpress-logo-notext-rgb

If you’ve been following my posts lately, you’ve seen me explore the tools question numerous times. In this post, I’ll explore combining structured authoring with web publishing on WordPress. In a nutshell, here’s the main idea: structured authoring tools are great for authoring content. Web platforms are great for publishing content. My plan is to Continue Reading »

Woes of conditional text and topichead elements (DITA best practices)

thumbconfusion

When authoring in DITA, there are a couple of best (or worst) practices that I wasn’t aware of. The first is with conditional text; the second is with topichead elements: Cautions with conditional text Noz Urbina has written two excellent articles about the dangers of going overboard with conditional text. When Conditional Content Goes Wild: Continue Reading »

Benefits of tool diversity, part II

In my previous post, Is tool fragmentation a good thing?, I lamented the trend toward tool fragmentation in the tech comm community, noting several disadvantages that fragmentation brings: fragmentation of community and knowledge sharing increased overhead of learning new tools frustration with HR departments who expect strong knowledge of their chosen tool (among hundreds) I Continue Reading »

Is tool fragmentation in tech comm a good thing?

writersua-tools-survey-2014

One of the attendees from Alan Houser‘s recent presentation at InfodevDEC meetup in Virginia the other night noted the following: #techcomm trends/hypes, from @arh: There's no one technology that a majority of people are using. @infodevdc — John Collins (@jrc_collins) August 4, 2014 Juxtapose this tweet about Alan’s presentation with the recent WritersUA Tools Survey Continue Reading »

Reviewing draft DITA content with subject matter experts: 6 essential points

oxygen-comments-thumb

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 Continue Reading »

My DITA quick reference guide (QRG)

dita-qrg-thumb-small

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. Why create this quick reference guide? There’s a lot to know about DITA. If you look at the DITA 1.2 spec there are many, many elements Continue Reading »