Blogs

Add to existing blog
Start your own blog

This page displays entries posted by all DITA XML.org bloggers in chronological order. You may also view entries by author or blog name as well as a list of DITA-related blogs on external sites.

In pursuit of the ultimate techCom information architecture

How Do We Bridge the Gap Between Academics and Practitioners in Tech Comm?

Practitioners find it difficult to see how the knowledge academics produce can be used to address real, practitioner-related problems. Why?

It goes deeper than academics failing to communicate with practitioners. The reason has to do with the fact that much of the academic research itself is weakly linked to the practical problems practitioners face. This fact is what makes practitioners uninterested in talking to academics— hence the gap.

Read more to find out how the gap could be bridged.

Read more

In pursuit of the ultimate techCom information architecture

Now Published in ISTC Communicator: How Do You Design for Findability?

Are you struggling with information architecture itself: What type of information should be organized, and in which manual? In the summer 2015 edition of ISTC Communicator, I present an approach to help you settle the struggle. Based on a viewpoint that users search for answers, I offer tips on how to design for findability.

Read more

In pursuit of the ultimate techCom information architecture

How Do You Define a User’s Information Need?

As a technical communicator, you probably know why you write manuals. It’s because you want to satisfy the user’s information need. But how do you know what information users need?

Your answer will differ depending on how you define an “information need,”  which is a central concept in the world of technical communication. The purpose of this article is to distinguish between two conflicting definitions of an information need, and to show how each perspective represented affects the design of end user assistance. 

Read more

In pursuit of the ultimate techCom information architecture

How Can We Help Users Judge the Relevance of Content?

It’s not difficult to find information— just open a user manual or search on Google. What users find difficult, is assessing whether the found information is relevant. Learn how to better support users in making accurate relevance judgments by designing your content for enhanced findability.

Read more

In pursuit of the ultimate techCom information architecture

Can Tech Writers Create Links without Even Writing Them?

This article discusses why links are important, and how technical communicators can make them without actually explicitly writing them.

The technical communication community has come to the agreement that creating a link strategy, and the actual links, is a time consuming affair.

In this article I show how links can be generated from content classification (that is, lists of metadata —taxonomies — used to classify content). 

Read more

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I