OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
  • 1.  Normative statements about

    Posted 06-24-2018 23:21
    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: From the content of a   <navtitle>   element in the map, if the containing   <topicref>   element sets the value of the   @locktitle   attribute to yes From the contents of a   <navtitle>   element in the referenced topic 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)


  • 2.  Re: [dita] Normative statements about

    Posted 06-25-2018 15:24
    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: From the content of a  <navtitle>  element in the map, if the containing  <topicref>  element sets the value of the  @locktitle  attribute to "yes" From the contents of a  <navtitle>  element in the referenced topic 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