Menu ▾ ▴

#742 23.4.3.2, ref-TEI: wrong impression regarding conformance (<text> singled out)

AMBER
closed-fixed
Peter Stadler
Guidelines (3)
5(default)
2015-03-10
2015-02-23
Piotr Banski
No

As pointed out by Peter Stadler[1], at two places, an impression is created that in order to qualify as TEI-conformant, a document "must contain either:

  • a single teiHeader element followed by a single text element, in that order; or
  • in the case of a corpus or collection, a single overall teiHeader element followed by a series of TEI elements each with its own teiHeader" (23.4.3.2) [2]

This is wrong, isn't it, and it creates a wrong impression. What we want to say is "a single teiHeader followed by either a single text element or one or more elements of model.resourceLike"

( teiHeader, ( ( model.resourceLike+, text? ) | text ) )

BTW, "in that order" in the current text is spurious after "followed by".

The wrong impression is further repeated in the ref-TEI documentation [3], in direct contrast with the formal element content declaration.

1: https://listserv.brown.edu/archives/cgi-bin/wa?A2=ind1502&L=tei-l&F=&S=&X=E4CBC00B9B19D92799&Y=bansp%40o2.pl&P=95570

2: http://www.tei-c.org/release/doc/tei-p5-doc/en/html/USE.html#CFAMmc

3: http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-TEI.html

Discussion

  • Peter Stadler

    Peter Stadler - 2015-02-23
    • assigned_to: Peter Stadler
     

  • Peter Stadler

    Peter Stadler - 2015-02-23

    Assigning to me because I think this issue is related to [feature-requests:#501]. (Doesn't mean I'll tackle it immediately, though ;)

     

    Related

    Feature Requests: #501

  • Piotr Banski

    Piotr Banski - 2015-02-23

    Super :-)
    And of course my suggested paraphrase above is faulty, but the formal declaration says it all -- maybe it's simply worth quoting, apart from the narrative stream.

     

  • Lou Burnard

    Lou Burnard - 2015-02-23

    This issue is indeed the same as previously raised in [feature-requests:#501], and is essentially a matter of rewording along the lines proposed by Piotr in the places indicated. Happy to undertake that if Peter is too busy!

     

    Related

    Feature Requests: #501

    • Piotr Banski

      Piotr Banski - 2015-03-03

      Since by the subliminal power of conformance statements, this piece can be seen by many as normative, I would encourage you to go ahead, Lou.
      I don't think Peter would mind (and if so, he'd be able to modify the text further -- for now, it's most important to align the prose with the formal declaration).

       

  • Piotr Banski

    Piotr Banski - 2015-03-03
    • Description has changed:

    Diff:

    --- old
+++ new
@@ -16,8 +16,8 @@
 The wrong impression is further repeated in the ref-TEI documentation [3], in direct contrast with the formal element content declaration.

-[1]: https://listserv.brown.edu/archives/cgi-bin/wa?A2=ind1502&L=tei-l&F=&S=&X=E4CBC00B9B19D92799&Y=bansp%40o2.pl&P=95570
+1: https://listserv.brown.edu/archives/cgi-bin/wa?A2=ind1502&L=tei-l&F=&S=&X=E4CBC00B9B19D92799&Y=bansp%40o2.pl&P=95570

-[2]: http://www.tei-c.org/release/doc/tei-p5-doc/en/html/USE.html#CFAMmc
+2: http://www.tei-c.org/release/doc/tei-p5-doc/en/html/USE.html#CFAMmc

-[3]: http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-TEI.html
+3: http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-TEI.html
     

  • Lou Burnard

    Lou Burnard - 2015-03-10

    Corrected wording in TEI tagdoc and added an example; also added a sentence or two to DS and USE at rev 13163

     

  • Lou Burnard

    Lou Burnard - 2015-03-10
    • status: open --> closed-fixed