Re: [dita] DITA 1.3 documentation -- shall we remove the Contains and "Contains by" tables

[Michael Priestley <mpriestl@ca.ibm.com>]

In an ideal world, put them in a separate
document (or separate documents - one per document type) and link to them.

Michael Priestley, Senior Technical Staff Member (STSM)
Total Information Experience (TIE) Technology Strategist
mpriestl@ca.ibm.com
http://dita.xml.org/blog/25



From:      
 Kristen James Eberlein
<kris@eberleinconsulting.com>
To:      
 DITA TC <dita@lists.oasis-open.org>,

Date:      
 09/11/2012 04:49 PM
Subject:    
   [dita] DITA
1.3 documentation -- shall we remove the Contains and "Contains by"
tables
Sent by:    
   <dita@lists.oasis-open.org>

---

As we start working on DITA 1.3 documentation,
we need to consider whether to include the Contains and "Contains
by" tables in the Language Reference topics.

Pro = Useful information
Con = Makes it impossible to search the spec and find information about
a specific element, since there are so many false hits. For example, if
you search the PDF version for indexterm, you get over 130 false hits before
you land on the actual topic.

Best, 
Kris 

Kristen James Eberlein 
Principal consultant, Eberlein Consulting 
Co-chair, OASIS DITA Technical Committee 
Charter member, OASIS DITA Adoption Committee 
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)