[tei-council] tcw20.xml (Editing the TEI Guidelines)

[Kevin Hawkins]

On 9/13/2012 2:47 PM, Lou Burnard wrote:
> On 13/09/12 19:23, Martin Holmes wrote:
>
>> We should decide whether it's the business of the Guidelines to cover
>> slightly peripheral and advanced topics such as Schematron. If so, it
>> would be easy to write a full section which assumes no knowledge on the
>> part of the reader. The TCW20 section could then refer to that part of
>> the Guidelines. But I'm not sure we really want to deal with Schematron
>> in the Guidelines in any more detail than is already here:
>>
>> <http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDTAGCONS>
>>
>
>
> I suggest that if there is any place where schematron per se needs to be
> discussed in the Guidelines, it should be in the "Gentle Intro" chapter,
> since this "...attempts to give an informal introduction to those parts
> of XML of which a proper understanding is necessary to make best use of
> these Guidelines"
>
> Of course, Schematron isn't exactly XML, but then neither is RelaXNG,
> which is also informally presented in this chapter, precisely because "a
> proper understanding" (read : cocktail party chat competence) of it is
> needed to grok how the Guidelines work. Same thing for Schematron, surely?
>
> How much needs to be added to what is already there in
> http://www.tei-c.org/release/doc/tei-p5-doc/en/html/SG.html#SG-val ?

Oh dear.  I always forget about chapter 22.  (In fact, I would probably 
be better at writing customizations if I consulted it in addition to 
chapter 23.)  So chap. 22 does indeed discuss Schematron.

Still, I think we should have a cross-reference from somewhere in 
chapter 23 to 
http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDTAGCONS so 
that people know they might write some constraints as part of their 
customization.

I think Schematron is already sufficiently covered in 
http://www.tei-c.org/release/doc/tei-p5-doc/en/html/SG.html#SG-val , but 
if someone wants to say more, I wouldn't be opposed to adding more.

--K.