[tei-council] Misleadingly invalid example

[Lou Burnard]

On 27/12/12 06:06, Martin Holmes wrote:
> The second example in this section of chapter 8:
>
> <http://teijenkins.hcmc.uvic.ca/job/TEIP5/lastSuccessfulBuild/artifact/release/doc/tei-p5-doc/en/html/TS.html#TSSASE>
>
> is marked (correctly) as invalid, because it contains an element defined
> in an external namespace as an extension to TEI (<ext:paraphasia>).
> However, the example is introduced as a demonstration of how to use the
> TEI @type attribute on <seg>:
>
> "Where segments of different kinds are to be distinguished within the
> same stretch of speech, the type attribute may be used, as in the
> following example:"
>
> and the extension element is only explained after the example.
>
> This is confusing. I'd like to re-draft this so that the initial
> example, demonstrating usage of @type, is valid, and the extension is
> introduced separately in a later, shorter example.
>
> Yell now to prevent same.
>
>


No yelling from me. I just note that the example is an authentic one, 
which is why it has the paraphasia in it. I would suggest simply 
splitting the example, and  motivating the use of the non-tei element by 
saying something like  "sometimes rather than say <seg type="weirdTerm"> 
it's more convenient to introduce <my:weirdTerm>"