A More Complete Draft ToC for Understanding an Managing Keys

[Keith Schengili-Roberts <keith.roberts@ixiasoft.com>]

I added to the original list, based on some further readings and a suggestion from Scott. Here's what the draft ToC looks like now:

Understanding and Managing Keys

 

Introduction

         About the source document

         Code samples

An introduction to keys

         A brief history of keys

         Key basics

         Advantages of keys

         Parts of a key

         Keys vs. variables

         Defining keys directly within a map

         Creating a keystore

         Using conkeyref

         Adding keys to topicrefs

         Keys and conditional processing

Advantages of Keys and Best Practices

         How to name your keys

         Defining a key strategy

         To key or not to key: understanding key complexity

         Managing sets of shared keys

         Working with product keys

         Working with graphics keys

         Working with user interface keys

         Working with Technical data keys

         Working with Relationship Table keys

         How and when to best use conkeyref

         Understanding key precedence

         Scoped key use for specific-purpose publications

         Scoped keys and cross-publication linking

References:

         "A Simple Guide to DITA Keys" by Keith Schengili-Roberts for TC Dojo 2017

         "Keys in Action" by Magda Caloian from DITA NA 2018

         "Growing up DITA" by Maria Essig from DITA NA 2018

         "Keys Applied-Practical Strategies for Designing, Using, and Managing DITA Keys" by Roger Hadley from DITA NA 2018

         "Ki, Qi, Key: The Way of DITA Harmony With Keys and Key References", by Eliot Kimber from TC Dojo 2018

         "Key Scopes in DITA 1.3 Finally!)" by Leigh White from DITA NA 2015

         "DITA 1.3 Feature Article: Understanding Scoped Keys in DITA 1.3" by Leigh White for DITA Adoption (whitepaper)

This may be a little too ambitious, but let me know your thoughts as to whether you think this draft ToC makes sense. 

If it gets too long maybe I will contact XML Press about a book idea. ð

Cheers!

 

-

Keith Schengili-Roberts

Market Researcher and DITA Evangelist

 

IXIASOFT 

825 Querbes, Suite 200, MontrÃal, QuÃbec, Canada, H2V 3X1

tel  + 1 514 279-4942  /  toll free + 1 877 279-4942 

robertsk@ixiasoft.com  /  www.ixiasoft.com