Style Guides: Fashionable But Also Practical

Having problems with inconsistently written documentation? Do your user manuals need some help themselves? If so, then you need a style guide for your technical writing team. We’re not talking about what they should wear, but how they should write.

Content couturier Keith Schengili-Roberts (IXIASOFT) talks about what they are, why you need them and how to use them effectively. While not exclusively focusing on DITA, Keith will also talk about why a style guide is a necessity for any team working with DITA.

Continue reading “Style Guides: Fashionable But Also Practical”

Working with DITA Maps in Arbortext

In Arbortext 7.0, creating, editing, and manipulating DITA maps is easy to do!  In this TC Dojo: Arbortext Edition, we cover the basics for creating, managing, and using maps in Arbortext Editor.

We show you how to insert all kinds of DITA content: Topics, Concepts, References, Tasks, other maps and more! We explain the Resource Manager, several ways to create new topics and manage or insert existing topics. If there’s time, we will discuss how you can create your own templates to create stub documents that get you started quickly creating standard information structures.

By the end, you’ll be a pro at working with DITA maps in Arbortext.

Continue reading “Working with DITA Maps in Arbortext”

DITA Keys and Conkeys

In this webinar, we tackle the DITA feature keyrefs and conkeyrefs. The keyref and conkeyref mechanisms allow you to easily switch variable content.

We will show how keys and key references are referenced by DITA maps; how processing is evaluated; how to combine keys with maps for easier manageability; and how to use conkey references instead of conref to simplify reuse and manage your content.

After that, we will talk about how keys and conkeys work, how they are resolved in the processing pipeline and how levels of map can help manage variable content.

Examples will be used to demonstrate how everything works using Arbortext.

Continue reading “DITA Keys and Conkeys”