<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright TEI Consortium.
Dual-licensed under CC-by and BSD2 licences
See the file COPYING.txt for details
-->
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?>
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0">
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title>TEI P5 version 3.3.0 release notes</title>
      </titleStmt>
      <editionStmt>
        <edition>
          <date when="2018-01-31">Wednesday, 31 January 2018</date>
        </edition>
      </editionStmt>
      <publicationStmt>
        <authority>The Text Encoding Initiative</authority>
      </publicationStmt>
      <sourceDesc>
        <p>created retrospectively from ChangeLog and GitHub trackers</p>
      </sourceDesc>
    </fileDesc>
  </teiHeader>
  <text>
    <body>
      
      <p>Release 3.3.0 (code name: <ref target="https://en.wikipedia.org/wiki/John_Lydon">Johnny Rotten</ref>) of the TEI Guidelines introduces 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. A full list of the issues resolved in
        the course of this release cycle may be found under the <ref target="https://github.com/TEIC/TEI/issues?q=is%3Aissue+milestone%3A%22Guidelines+3.3.0%22+is%3Aclosed">3.3.0 milestone</ref>.</p>
      
      <p>Highlights of this release include: <list>
        
        <item>A new attribute class <name type="class">att.linguistic</name> has been introduced.
          The existing attributes <att>lemma</att> and <att>lemmaRef</att> are now members of the
          new attribute class, the attributes <att>pos</att>, <att>msd</att> and <att>join</att>
          were newly introduced. The elements <gi>w</gi> and <gi>pc</gi> are members of <name type="class">att.linguistic</name> (<ref target="https://github.com/TEIC/TEI/issues/1670">#1670</ref>). </item>
        
        <item>The <gi>form</gi> element is now a member of <name type="class">att.typed</name>
              (<ref target="https://github.com/TEIC/TEI/issues/1688">#1688</ref>). </item>

        <item>The <gi>gb</gi> element is now a member of <name type="class">att.edition</name>
              (<ref target="https://github.com/TEIC/TEI/issues/1677">#1677</ref>). </item>
        
        <item>The element <gi>etym</gi> is now a member of <name type="class">att.typed</name> and permits
          recursive <gi>etym</gi> elements (<ref target="https://github.com/TEIC/TEI/issues/1512">#1512</ref>).</item>
        
        <item>The elements <gi>c</gi>, <gi>cl</gi>, <gi>hyph</gi>, <gi>m</gi>, <gi>orth</gi>,
          <gi>phr</gi>, <gi>quote</gi>, <gi>s</gi>, <gi>seg</gi>, <gi>stress</gi>, <gi>syll</gi>
          and <gi>w</gi> are now members of <name type="class">att.notated</name>, and thus now
          can have the <att>notation</att> attribute (<ref target="https://github.com/TEIC/TEI/issues/1510">#1510</ref>, <ref target="https://github.com/TEIC/TEI/issues/1514">#1514</ref>, <ref target="https://github.com/TEIC/TEI/issues/1734">#1734</ref>).</item>
        
        <item><gi>remarks</gi> is now permitted as a child of <gi>valItem</gi> if <gi>desc</gi> is also a child (<ref target="https://github.com/TEIC/TEI/issues/1420">#1420</ref>).</item>
        
        <item><gi>bibl</gi> is now permitted in <gi>witDetail</gi> (<ref target="https://github.com/TEIC/TEI/issues/1425">#1425</ref>).</item>
         
        <item>The content model of <gi>affiliation</gi> in the jTEI schema has been expanded and allows
          <gi>placeName</gi> now (<ref target="https://github.com/TEIC/TEI/issues/1692">#1692</ref>). </item>
        
        <item>A number of content models have been improved, including: 
          <list>
            <item>the <gi>listRef</gi> element (<ref target="https://github.com/TEIC/TEI/issues/1674">#1674</ref>)</item>
            <item>the <gi>content</gi> element (<ref target="https://github.com/TEIC/TEI/issues/1719">#1719</ref>, <ref target="https://github.com/TEIC/TEI/issues/1716">#1716</ref>)</item>
            <item>the <gi>choice</gi> element (<ref target="https://github.com/TEIC/TEI/issues/1690">#1690</ref>)</item>
          </list>
        </item>
        
        <item>
          The explanations and discussions of several features have been improved:
          <list>
            <item>the inconsistent definition of the <att>reason</att> attribute for <gi>gap</gi> and <gi>unclear</gi> has been unified (<ref target="https://github.com/TEIC/TEI/issues/1729">#1729</ref>)</item>
            <item>the description of the <gi>content</gi> element has been clarified (<ref target="https://github.com/TEIC/TEI/issues/1718">#1718</ref>), as well as the prose discussing its use for writing content models (<ref target="https://github.com/TEIC/TEI/issues/1459">#1459</ref>)</item>
            <item>the description of the <gi>move</gi> element has been clarified (<ref target="https://github.com/TEIC/TEI/issues/1705">#1705</ref>)</item>
          </list>
        </item>
        
        <item>A new Exemplar called tei_customization has been added. It supports writing a TEI
            customization by hand (<ref target="https://github.com/TEIC/TEI/issues/1349">#1349</ref>).</item>
        
        <item>The appendices A to E now mention the number of distinct items included in them (<ref target="https://github.com/TEIC/TEI/issues/1517">#1517</ref>).</item>
        
        <item>The macro macro.anyXML is now deprecated (<ref target="https://github.com/TEIC/TEI/issues/1585">#1585</ref>),
          as <gi>anyElement</gi> is available.</item>
        
        </list>
      </p>

      <p>Dozens of wording improvements and corrections of typographic errors have been
        made to the <title>Guidelines</title>.</p>

      <p>In addition, many improvements have been made to the XSLT
      stylesheets (which provide processing of TEI ODD files for <ref target="http://www.tei-c.org/Roma/">Roma</ref> and <ref target="http://www.tei-c.org/ege-webclient/">OxGarage</ref> as
      well as other TEI conversions). The Stylesheets are maintained
      separately from the Guidelines and are at <ref target="https://github.com/TEIC/Stylesheets">https://github.com/TEIC/Stylesheets</ref>.
      </p>
    </body>
  </text>
</TEI>
