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

[Martin Holmes]

On 12-09-13 11:47 AM, 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 ?

I would say there's enough there. Schematron is not very hard to figure 
out, assuming you know XPath, and impossible if you don't, so XPath 
would be the actual stumbling block; would we want to start teaching 
people XPath too? I think where good tutorials and intros exist outside 
the Guidelines for topics like this, we should try to stay away from 
covering them, in the interest of keeping the size of the Guidelines 
under control.

An brief listing of related technologies (schema languages, XPath, XSLT, 
XQuery, Schematron, etc. etc.), along with links to good tutorials and 
reasons why you might (or might not) find it useful to learn about them 
would be a good idea, though.

Cheers,
Martin

-- 
Martin Holmes
University of Victoria Humanities Computing and Media Centre
(mholmes at uvic.ca)