[tei-council] TEI Examples

[Sebastian Rahtz]

strikes me that Saašha makes some very valid points here about missing summaries and examples.


On 23 Nov 2013, at 23:01, Saašha Metsärantala <saasha at ACC.UMU.SE> wrote:

> ….
> There is a huge number of XML vocabularies. When I come in contact with a new XML vocabulary, I almost always feel disappointed about not finding a SHORT summary presenting this vocabulary for XML experts. The TEI was no exception at all: I did not find any one-page-long document called something similar to "A short introduction to TEI for XML experts" (assuming a good knowledge of XSLT, xs: datatypes, namespace techniques, customizations, etc.). Such a document would be extremely welcome by (thousands of) XML-acquainted people who want to check whether (and maybe discover that) TEI may be useful for their purposes.
> 
> This "TEI for XML experts" page should give the information its title suggests and also contain two links:
> 
> 1) one link to a set of appropriate example instances (TEI documents)
> 
> 2) one link to the schema(s) of the vocabulary (TEI in this case)
> 
> The set of example instances should contain a MINIMAL number of realistic TEI documents written by TEI *EXPERTS* for exactly this purpose and each of these TEI documents should be as short as possible. Nonetheless, they should contain all the most significant use-cases and show best-practice for EVERY (non-deprecated) element and attribute of the vocabulary. In other words: Reading (the XML source of) these TEI instances should give any XML expert a good knowledge to start using the vocabulary. Of course, I am aware that some XML vocabularies (TEI among others) contain quite many elements and attributes, which makes it difficult to limit the size and number of example instances. Nonetheless, any redundancy should be avoided here.
> ...

--
Sebastian Rahtz
Director (Research) of Academic IT
University of Oxford IT Services
13 Banbury Road, Oxford OX2 6NN. Phone +44 1865 283431