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.