Fwd: [dita-comment] RE: noting a few limitations in my FrameMaker-to-DITA migration effort

Latest e-mail from dita-comment. Thoughts about a response?

    

    
Best,

      Kris

      

      Kristen James Eberlein

      Chair, OASIS DITA Technical Committee

      Principal consultant, Eberlein Consulting

      www.eberleinconsulting.com

      +1 919 622-1501; kriseberlein (skype)

      

    

    

      

      -------- Forwarded Message --------
      
        
          

            Subject:
            
            [dita-comment] RE: noting a few limitations in my
              FrameMaker-to-DITA migration effort
          

          

            Date: 
            Tue, 30 Apr 2019 19:24:43 +0000
          

          

            From: 
            Chris Papademetrious
              <>
          

          

            To: 
            ''
              <>
          

        
      
      

      

      
      
      
      

        
As a follow-up to my 12/7/2018 post, it *would*
          actually be nice to have the <bookmap> content model
          expanded to allow <part> elements within large
          <appendix> sets. I officially change my position on that
          from “no action requested” to “I want it”.  :)

        
 

        
Adding the following:

        
 

        
*****

        
Item 3: Please allow <example>
          elements within <section> elements.

        
 

        
I am specializing the <section>
          element to represent a particular structure within a topic
          (such as short description, syntax, arguments, return results,
          and examples). For example,

        
 

        
<topic id=”foo”>

        
  <title>My Topic Title</title>

        
  <body>

        
    <description-section>

        
    </description-section>

        
    <syntax-section>

        
    </syntax-section>

        
    <arguments-section>

        
    </arguments-section>

        
   <example-section>

        
     <example>

        
       <title>Single-Phase
          Example</title>

        
       ...figures, tables, or other
          content...

        
     </example>

        
     <example>

        
       <title>Multi-Phase
          Example</title>

        
       ...figures, tables, or other
          content...

        
     </example>

        
    </example-section>

        
    <license-section>

        
    </license-section>

        
  </body>

        
 
          <related-links>...</related-links>

        
</topic>

        
 

        
However, the <section> element
          doesn’t allow <example> within it, which blocks me from
          using a proper structure for the examples section. Using
          nested <topic>s instead of <section>s isn’t an
          option because then the <related-links> must be first in
          the topic, then the nested-and-specialized topics which
          actually contain the information.

        
 

        
For specialization purposes, please allow
          <example> in <section>!

        
 

        
-----

          Chris Papademetrious

        
Tech Writer, Implementation Group

        
(610) 628-9718 home office

        
(570) 460-6078 cell