> More precisely, I'll mostly use it for examples commenting specific
> sections or paragraphs. In fact, I have two kinds of examples. Big ones,
> I'd like to put in-flow like the DocBook <example> tag; and shorter ones,
> I'd like to place as marginalia. But there is no real semantic
> differentiation between them... *despaired sigh*
> <p id="p1">Blurb</p>
> <note type="example" place="margin">Marginalia comment about the
> p2 paragraph.</note>
> <p id="p2">Blurb</p>
> <p id="p3">Blurb</p>
> <note type="example" place="inline">Long example relating to the
> p2 and p3 paragraphs</note>
> <p id="p4">Blurb</p>
The first example is certainly a <note>. If you want to keep the longer
examples as notes as well, then you should redefine the content of <note>
using the TEI extensions mechanism to permit the structures you want (just
ripping the content model from <div> would probably be best).
> > Should you ever try to place a <p> after a sibling-level
> > <div> then the inherent order of the universe will be
> > disrupted, and Heaven help us all...
> Er... I don't understand this. Could you explain it with more details? How
> does this apply to my example?
> I think I remember that in the introduction to TEI Lite, it's recommended
> to place <note>'s just before the paragraph it comments.
Slightly facetiously put, I'm afraid, in reference to a intermittant but
long-running dispute on this list. If you were to decide to keep your
marginalia as <note>s, but to use <div type="example"> for the longer inline
stuff, then you might think your example above would be tagged as:
<note type="example" place="margin">Marginalia comment about the
<div type="example" place="inline">
<p>Long example relating to the p2 and p3 paragraphs.</p>
However, the TEI does not permit this. The paragraph p4 is coming *after* a
division, but at the same hierachical level as that division. It would
fail validation as a result. Your choices here are (a) redefine <div> to
allow this in your extensions, (b) create an <example> element yourself and
permit it within %inter; or similar, (c) add your voice to the growing
chorus of those saying "I'll have my <p>s where I want them", or take the
official route of (d) adding the post-example stuff in an anonymous <div>.
 See the thread
1 for a general discussion on this, in particular
9 for the reasons why this is prohibited, and
for a refutation thereof.