What’s new, cool, useful and powerful in DITA. Learn DITA best practices.


Reuse in DITA: reusing topics

DITA enables reuse on many levels. This post discusses some tactics for reusing topics. Reusing Topics Referring to DITA maps from a book map or from another DITA map provides a great way for grouping topics. Refer to the DITA map in the…

In DITA, how small is too small for conditional content that will be translated

Like many great questions, the answer to “how small is too small for conditional content” is – it depends. If the content will be translated, then mitigating future translation costs is a key factor.  This post will consider just one…

Keyref mechanism or conditions in DITA

Use the keyref mechanism for a change that will be made globally and will appear in many locations in your content. For example, a product name is a great candidate for a keyref.  As your product name changes over time, your content…

Why use keyref in DITA?

Keyrefs make extensive content reuse easier to maintain and enable sophisticated conditional processing (profiling) of content. When you do not use keys, then  extensive use of related links, cross references, and conrefs result in a loss…

Considerations for using using conditions in a conref

When the content of your conref needs to change — as in for different audiences or for different products — conditions enable your conref to adapt! You should, however, consider using conkeyref (for large reusable chunks) or using keyref…

Machine Industry Task Topic

We often recommend that customers who do not create or service machinery adopt the machine industry task topic type. Software companies, chemical companies, financial firms, and many others are leveraging the power of the machine industry task…

Is Markup Mentoring for Me?

Ongoing content audits, or – as we prefer to call it – markup mentoring bridges the gap from your DITA plan to your DITA implementation.  Semantic markup mentoring will increase the effectiveness of your DITA content, reduce long term…