OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
  • 1.  "name" attribute on audience element

    Posted 11-19-2013 14:24
    According to the specification, the name attribute is required on the <audience> element: http://docs.oasis-open.org/dita/v1.2/os/spec/langref/audience.html I know that the DTD we ship does not require it - actually, it didn't in DITA 1.1 or even DITA 1.0. I noticed this bug while doing some prototypes of new attribute displays in the specification. Technically - the specification is canonical, thus the DTD is in error on this point and has been since 1.0. However, I suggest that we just relax this in the 1.3 specification and remove any mention of it being required. This change would be backwards compatible (easy to go from required to non-required), and as a bonus, we wouldn't break any current users by "fixing" the DTD / XSD. Also, I feel sure that if we had been shipping it as required in the DTD, somebody would have asked us to relax that by now. Any objections? Robert D Anderson IBM Authoring Tools Development Chief Architect, DITA Open Toolkit ( http://dita-ot.sourceforge.net/ )


  • 2.  Re: [dita] "name" attribute on audience element

    Posted 11-19-2013 14:30
    Definitely agree with Robert's suggestion. Sent from my iPad JoAnn Hackos Comtech Services Inc 710 Kipling Street Suite 400 Lakewood CO 80215   CIDM will be hosting the Content Management Strategies/DITA Europe Conference 2013 in Munich, Germany  November 18-19.  More information at: http://www.infomanagementcenter.com/DITAeurope/2013/index.htm On Nov 19, 2013, at 7:24 AM, "Robert D Anderson" < robander@us.ibm.com > wrote: According to the specification, the name attribute is required on the <audience> element: http://docs.oasis-open.org/dita/v1.2/os/spec/langref/audience.html I know that the DTD we ship does not require it - actually, it didn't in DITA 1.1 or even DITA 1.0. I noticed this bug while doing some prototypes of new attribute displays in the specification. Technically - the specification is canonical, thus the DTD is in error on this point and has been since 1.0. However, I suggest that we just relax this in the 1.3 specification and remove any mention of it being required. This change would be backwards compatible (easy to go from required to non-required), and as a bonus, we wouldn't break any current users by "fixing" the DTD / XSD. Also, I feel sure that if we had been shipping it as required in the DTD, somebody would have asked us to relax that by now. Any objections? Robert D Anderson IBM Authoring Tools Development Chief Architect, DITA Open Toolkit ( http://dita-ot.sourceforge.net/ ) --------------------------------------------------------------------- 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


  • 3.  Re: [dita] "name" attribute on audience element

    Posted 11-20-2013 04:26
    I agree with Robert’s suggestion. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com On 11/19/13, 3:24 PM, "Robert D Anderson" <robander@us.ibm.com> wrote: > >According to the specification, the name attribute is required on the ><audience> element: > http://docs.oasis-open.org/dita/v1.2/os/spec/langref/audience.html > >I know that the DTD we ship does not require it - actually, it didn't in >DITA 1.1 or even DITA 1.0. I noticed this bug while doing some prototypes >of new attribute displays in the specification. > >Technically - the specification is canonical, thus the DTD is in error on >this point and has been since 1.0. However, I suggest that we just relax >this in the 1.3 specification and remove any mention of it being required. >This change would be backwards compatible (easy to go from required to >non-required), and as a bonus, we wouldn't break any current users by >"fixing" the DTD / XSD. Also, I feel sure that if we had been shipping it >as required in the DTD, somebody would have asked us to relax that by now. > >Any objections? > >Robert D Anderson >IBM Authoring Tools Development >Chief Architect, DITA Open Toolkit ( http://dita-ot.sourceforge.net/ ) > > >--------------------------------------------------------------------- >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 >