Release 3.1.0

Dear TEI-Listers,

The TEI Consortium has released the TEI Guidelines version 3.1.0 (Codename:
Tea Day). Our release technicians today were James Cummings and Magdalena
Turska, assisted by Martin Holmes and myself. I am happy to report that the
release went very smoothly. For more details, please see the release notes
attached below.

As always, we encourage you all to report bugs and make feature requests
via the new GitHub site at https://github.com/TEIC/TEI/issues. Your input
is how we know what to work on, and we cannot do without it! All of the TEI
Consortium’s software projects are hosted at https://github.com/TEIC and
issues or feature requests should be reported at the various project
repositories there. The Guidelines are available from all the usual places
(such as the TEI website
http://www.tei-c.org/release/doc/tei-p5-doc/en/html/index.html and the
GitHub site https://github.com/TEIC/TEI/releases/tag/P5_Release_3.1.0). A
new release of the TEI Stylesheets has been made in conjunction with the
3.1.0 release at https://github.com/TEIC/Stylesheets/releases/tag/v7.42.0.
The updated oxygen-tei package is available at
https://github.com/TEIC/oxygen-tei/releases/tag/v6.1.0. Debian users will
note that there has not been a proper Debian release of the TEI packages in
some time. We have not yet come up with a good replacement for the
repository that used to be maintained by Sebastian Rahtz, but unsigned
packages are available at
http://jenkins.tei-c.org/job/TEIP5/lastSuccessfulBuild/artifact/P5/ and
http://jenkins.tei-c.org/job/Stylesheets/lastSuccessfulBuild/artifact/. The
release notes are also linked from the footer of the online Guidelines (
http://www.tei-c.org/release/doc/tei-p5-doc/readme-3.1.0.html).

All the best,
Hugh Cayless


Release Notes:

This release (Codename: Tea Day) marks the completion of two major new
features introduced in the previous release. First, Pure ODD is now
completely pure: all content models in TEI ODDs may now be represented
entirely in TEI, with no requirement for RELAX NG (which may still be used
if desired). In the previous release, RELAX NG was still needed in macros
that permitted any XML content, which are used in content models such as
<egXML>. Second, this release contains the first Exemplar which implements
the Processing Model specification introduced in 3.0.0 and produced as part
of the work of the TEI Simple project, which was funded by the Andrew W.
Mellon Foundation. TEI simplePrint is an entry-level customization, focused
primarily on the needs of those encoding Western European early modern
printed material such as that produced by the Text Creation Partnership. We
hope that, beyond its value as a customization for working with this type
of material, it will serve as a template for producing other new
customizations that leverage the Processing Model.

Release 3.1.0 of the TEI Guidelines also introduces other new features and
resolves a number of issues raised by the TEI community. As always, the
majority of these changes and corrections are a consequence of feature
requests or bugs reported by the TEI community using the GitHub tracking
system. If you find something you think needs to change in the TEI
Guidelines, schemas, tools, or website, please submit a feature request or
bug issue at https://github.com/TEIC/TEI/issues for consideration. A full
list of the issues resolved in the course of this release cycle may be
found under the 3.1.0 milestone.

* The source attribute is now global.
* There is a new <schemaRef> element for pointing to one's TEI ODD
customization.
<note> and <witDetail> are now permitted in <rdgGrp>.
* A new datatype teidata.prefix has been introduced to allow restricting an
attribute value to one that could be use as a URI scheme name.
* The ident attribute of <prefixDef> is now restricted to the new
teidata.prefix datatype. This will avoid errors which would occur if a
character that is not legal as a URI scheme were used as part of this
attribute’s value.
* Further formal constraints on the output and predicate attributes of
<model> have been added to try to help users avoid ambiguous sets of
<model>s elements.
* ISO Schematron is now the only flavor of Schematron used or supported by
the Guidelines.
* The following constructs are now deprecated:
     -the value 'isoschematron' of scheme of <constraintSpec> (use
'schematron' instead, as they mean the same thing now).
     -the default value (false) of defective of att.msExcerpt
     -the default value (unknown) of status of <availability>
     -the default value (unknown) of status of <correction>
     -the default value (unknown) of aloud of <said>
     -the default value (unknown) of discrete of <sound>
* The rules regarding <f>, its content, and its fVal attribute, have been
cleaned up to fix a contradiction.
* The <title> element is now a member of att.datable.
* The <listBibl> element is now a member of model.frontPart.
* A new element called <anyElement> has been introduced, which permits any
XML content in a content model. This removes the last remaining requirement
for RELAX NG in content models, allowing us to define TEI entirely in TEI.
* A new element called <dataFacet> for restricting references to W3C
datatypes in ODD has been introduced.
<supplied> is now part of model.choicePart, so it can be used within
<choice>.
* A new attribute require has been added to att.textCritical. It can be
used to indicate interdependance between variant readings.
* The extent attribute on the <orth> and <pron> elements no longer has a
default value.
* A new Exemplar called simplePrint has been added. Developed as part of
the TEI Simple project, it makes extensive use of the processing model
techniques introduced in the previous release and is fully documented by
the ODD included in this release.
* The TEI conference and members meeting 2016 in Vienna saw the first
‘TEI2German Translatathon’ to translate several descriptions, glosses, and
remarks of the TEI specification into German. The results of this community
effort have been added to this release – many thanks again to all
participants and the local organizers for all the commitment and enthusiasm!

In addition, dozens of wording improvements and corrections of typographic
errors have been made to the Guidelines.

Many improvements, including support for the new <anyElement> and for the
minOccurs and maxOccurs attributes used by Pure ODD have been made to the
XSL stylesheets (which provide processing of TEI ODD files for Roma and
OxGarage as well as other TEI conversions). The Stylesheets are maintained
separately from the Guidelines and are at
https://github.com/TEIC/Stylesheets.