Pay no GREAT attention to that man behind the curtain
Every department has its resident tech wizard: the maintainer of the templates, the DITA Open Toolkit, the wiki, and so on. What happens when that wizard flies off to a new kingdom?
Author: Alan Pringle
From tech writer to DITA superhero
In the world of superheroes, technical writers could just slide down a pole or do a clandestine spin to transform themselves into DITA technologists. Of course, nothing is that easy, so what does the transformation from tech writer to DITA superhero really require?
Five questions to ask before distributing content as HTML
HTML5! Mobile! Responsive design!
It’s easy to get distracted by sparkly buzzwords when you investigate distributing your technical content as HTML. Instead, focus on a few basic but essential questions:
Adapt or die: style guide edition
Being cognizant of your environment and adapting accordingly is a good survival technique for any being (as Darwin recognized), and it’s particularly true in the professional world. And that’s why I’m puzzled by how much time tech writers spend agonizing over style and word choices in tech comm forums, on Twitter, and elsewhere.
Mission: Impossible? Consistently good ebook formatting across devices
Your mission, should you decide to accept it: distribute content as ebooks.
Gone with the width: what’s the optimal length for a line of text?
When it comes to a line of text, how long is too long? And do the rules for text column width change when content is rendered on different devices?
Perils of DITA publishing, part 7: the displeasures of distributing ebooks
In which we uncover some unpleasant realities about distributing ebook editions.
Perils of DITA publishing, part 3: Indexing
In which we are boxed in by the limitations of DITA indexing support.
Let go of your silo
In reality, collaborative authoring is little more than a euphemism for the idea that “anyone can write.”
That’s Tom Johnson’s take on collaborative authoring in his latest blog post. The writer in me sympathizes deeply because the “anyone can write” attitude is a direct challenge to the careers of professional writers.
When perceptions bite tech comm’s backside
It can be a mightily sucktacular experience when you discover what other people think technical communicators do.
