Re: [dita] Stage one proposal: Changes to indexing

From
Robert D Anderson <>
Date
2019-06-10T15:14:47+00:00
ID
Thread
Re: [dita] Stage one proposal: Changes to indexing
I assume this would also allow us to remove <index-base>. It's one of those "only there for specialization" elements, put in so that we could specialize the see + see-also + sort-as elements while adding only one base element. I've never heard of it being used for anything else -- has anybody else?

Having index-base does (theoretically) let us say "This is only one base element and other things are just domains", Practically though -- if you're not using indexing, you never see any of these elements (because they only show up after you've added an index term). For those who are using indexing, index-base is a confusing element to see, and I've heard that for some it's standard practice to set up constraints to keep it out.

I like the idea here - I think it simplifies the architecture, gets rid of redundant elements, and (bonus) will make the specification much simpler by letting us describe all of the index functions as a single core part of the spec.

Robert D Anderson
IBM Authoring Tools Development
Chief Architect, DITA Open Toolkit  (http://dita-ot.sourceforge.net/)

Kristen James Eberlein ---06/08/2019 01:04:29 PM---Back history: <indexterm> was part of DITA 1.0 The indexing domain (<index-see>, <index-see-also>, a

From:        Kristen James Eberlein <>
To:        DITA TC <>
Date:        06/08/2019 01:04 PM
Subject:        [EXTERNAL] [dita] Stage one proposal: Changes to indexing
Sent by:        <>

Back history:

<indexterm> was part of DITA 1.0

The indexing domain (<index-see>, <index-see-also>, and <index-sort-as>) and <index-base>was introduced in DITA 1.1.

In DITA 1.3, we added <sort-as>.I want to suggest that we clean this up for DITA 2.0:

Remove the indexing domain, and add <index-see> and <index-see-also> to the base

Remove <index-sort-as> and just use <sort-as>-- 
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php