[tei-council] formatting of guidelines - schema fragments

[Dan O'Donnell]

On Thu, 2007-12-04 at 11:19 +0100, James Cummings wrote:
> Sebastian Rahtz wrote:
> > I know we have a work task on this, but that
> > may not address a fundamental issue I have.
> 
> Probably not, so we'd appreciate hearing of any other issues you have.
> 
> > When reading one of my allocated chapters,
> > I was struck by the inclusion of schema fragments
> > in the section with the formal definition
> > of elements. What is the point of them, I wondered?
> > The technical details are available in the
> > alphabetical list of elements etc (the "second
> > volume", if you like), for those who can read
> > this stuff, so why repeat it here?
> 
> I assume so that readers don't have to go elsewhere to find out the
> nitty-gritty of the elements they have been reading about. Might it be
> better to move these all to the end of the chapter? i.e. each chapter has
> section at the end for all the formal declarations?
> 
> > More importantly,
> > the code shown is simply one interpretation
> > of the ODD (ie it divides each element into
> > two patterns, foo.content and foo.attributes),
> > which is not normative.
> > 
> > Has this bothered anyone else?
> 
> No, I hadn't even considered it. (tbh)  However, I do see that it is a bit
> strange that we are saying ODD is the way and then showing one particular
> interpretation of that ODD as Relax NG Compact Syntax throughout the
> guidelines.

I agree. Good catch, Sebastian--although you don't seem to do any other
kind!


> 
> -James
> 
-- 
Daniel Paul O'Donnell, PhD
Chair, Text Encoding Initiative <http://www.tei-c.org/>
Director, Digital Medievalist Project <http://www.digitalmedievalist.org/>
Associate Professor and Chair of English
University of Lethbridge
Lethbridge AB T1K 3M4
Vox: +1 403 329 2378
Fax: +1 403 382-7191
Homepage: http://people.uleth.ca/~daniel.odonnell/