OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
  • 1.  Question about titles in example

    Posted 23 days ago
    Hi everyone,

    As some of you may remember ... the original definitions of <section> and <example> were identical. In the DTD, they even used the same content model (both set the parameter "section.cnt" as the content model). This means that, from DITA 1.0, both have allowed any number of titles.

    This is an artifact of DTD rules; because allow text in sections, we cannot mandate "one optional title" or "title must come first".



    For 2.0 drafts (already reviewed), we more clearly state that it is a content error for section to have more than one title.

    The question: should we say the same for example? I think yes, as we've always treated it as a section (and in fact describe it as "a section" in the 1.3 text).

    Thanks,
    Robert



  • 2.  RE: Question about titles in example

    Posted 22 days ago
    Except in 1.3 Example is based on fig?

    Scott Hudson
    Staff Technical Content Architect
    Content Operations and Experiences
    ServiceNow





  • 3.  RE: Question about titles in example

    Posted 21 days ago

    I agree that <example> should have the same rules for <title> as <section>: At most one, must be first element child of <example>.

     

    Cheers,

     

    E.

     

    _____________________________________________

    Eliot Kimber

    Sr Staff Content Engineer

    Digital Content & Design

    O: 512 554 9368

    M: 512 554 9368

    servicenow.com

    LinkedIn | Twitter | YouTube | Facebook