[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: 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 --------
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>! ----- Tech Writer, Implementation Group (610) 628-9718 home office (570) 460-6078 cell |
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]