Re: [dita] Normative statements about <navtitle>

[Eliot Kimber <ekimber@contrext.com>]

I was tempted to say that it should be a “MUST” but ultimately the presentation details of the content are a matter of style and thus which alternative a given processor chooses to use must be up to the processors, so I think SHOULD is the only option.

 

As a general principle, the only invariant processing rules relate to address resolution because without consistency in address resolution there is no hope of consistency in processing behavior (that is, determining what the effective content of a given set of publications processed as a unit is, irrespective of how those publications might be presented). (And even here we allow a difference in how filtering is applied for historical reasons.)

 

All other aspects of processing are ultimately a matter of style, even where there are strong suggestions as to what the intended result should be.

 

Cheers,

 

E.

 

--

Eliot Kimber

http://contrext.com

 

 

 

From: <dita@lists.oasis-open.org> on behalf of Kristen James Eberlein <kris@eberleinconsulting.com>
Date: Sunday, June 24, 2018 at 6:20 PM
To: DITA TC <dita@lists.oasis-open.org>
Subject: [dita] Normative statements about <navtitle>

 

We have the following content in the draft DITA 2.0 topic for <navtitle>

Processing expectations

When the <navtitle> element is used in a topic, processors should use the contents of the element to generate the navigation title.

When the <navtitle> element is used in a map, processors should retrieve the navigation title in the following order:

1. From the content of a <navtitle> element in the map, if the containing <topicref> element sets the value of the @locktitle attribute to "yes"
2. From the contents of a <navtitle> element in the referenced topic
3. From the title of the referenced topic

The lower-case "should" is from the DITA 1.x spec; I suspect that we want normative language here for DITA 2.0.

But do we want to make it SHOULD or MUST?

--
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