Skip to content

Commit

Permalink
first draft of release notes
Browse files Browse the repository at this point in the history
  • Loading branch information
martinascholger committed Apr 15, 2022
1 parent 28367cd commit 6f9fd2a
Showing 1 changed file with 143 additions and 0 deletions.
143 changes: 143 additions & 0 deletions P5/ReleaseNotes/readme-4.4.0.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,143 @@
<?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 4.4.0 and Stylesheets version 7.53.0 release notes</title>
</titleStmt>
<editionStmt>
<edition>
<date when="2022-04-19">Tuesday, 19 April 2022</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 4.4.0 is codenamed <q>XXX</q>.</p>
<p>This release 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+4.4.0%22+is%3Aclosed"
>4.4.0 milestone</ref>.</p>


<!--
add more issues
#1735
#1869
#2167
#2187
#2231
#2236
+ translations?
+ PRs
-->


<p>The following changes are particularly worth highlighting in this release: <list>
<head>Changes to content models</head>
<item>The <gi>listRef</gi> element is now member of the element class <ident type="class"
>model.ptrLike</ident>. Furthermore, constraints on the use of <gi>listRef</gi> within
<title>Documentation Elements</title> have been added and the remark has been updated.
(<ref target="https://github.com/TEIC/TEI/issues/1667">#1667</ref> and <ref
target="https://github.com/TEIC/TEI/issues/2209">#2209</ref>).</item>
</list>
<list>
<head>Improvements of prose and examples</head>
<item>The descriptions of the legal values of the <att>mode</att> attribute in the
attribute class <ident type="class">att.combinable</ident> has been clarified (<ref
target="https://github.com/TEIC/TEI/issues/1715">#1715</ref>).</item>
<item>The description of the <val>URI</val> value of the <att>type</att> attribute of the
<gi>idno</gi> element has been improved (<ref
target="https://github.com/TEIC/TEI/issues/2071">#2071</ref>).</item>
<item>Several typos have been corrected (<ref
target="https://github.com/TEIC/TEI/issues/2178">#2178</ref>, <ref
target="https://github.com/TEIC/TEI/issues/2181">#2181</ref>), <ref
target="https://github.com/TEIC/TEI/issues/2186">#2186</ref>, <ref
target="https://github.com/TEIC/TEI/issues/2191">#2191</ref>, <ref
target="https://github.com/TEIC/TEI/issues/2198">#2198</ref>.</item>
<item>The prose in the subsection on <ref
target="https://www.tei-c.org/Vault/P5/4.4.0/doc/tei-p5-doc/en/html/DS.html#DSGRP"
>Grouped Texts</ref> has been updated (<ref
target="https://github.com/TEIC/TEI/issues/2203">#2203</ref>).</item>
<item>The description for the <gi>msDesc</gi> element has been improved (<ref
target="https://github.com/TEIC/TEI/issues/2218">#2218</ref>).</item>

<item>The identifiers of <att>ident</att> attributes in <gi>constraintSpec</gi> elements
have been made unique (<ref target="https://github.com/TEIC/TEI/issues/2223"
>#2223</ref>). </item>

</list>
<list>
<head>Housekeeping</head>

<item>tei_dictionaries.odd has been removed from Exemplars (<ref
target="https://github.com/TEIC/TEI/issues/1572">#1572</ref>).</item>

<item>The deprecated elements charName, charProp, glyphName, localName, unicodeName, and
value have been removed (<ref target="https://github.com/TEIC/TEI/issues/2232"
>#2232</ref>).</item>

<item>The decprecated constraint on the <gi>schemaSpec</gi> element, which withdrew the
usage of the element in various places, has been removed (<ref
target="https://github.com/TEIC/TEI/issues/1921">#1921</ref>).</item>

<item>The inconsistent phrase-level encoding of macros has been unified (<ref
target="https://github.com/TEIC/TEI/issues/2192">#2192</ref>).</item>

<item>Outdated references to Sourceforge have been removed (<ref
target="https://github.com/TEIC/TEI/issues/2206">#2206</ref>).</item>

<item>The targets for generating PDF in the P5/Makefile have been renamed for better
orientation (<ref target="https://github.com/TEIC/TEI/issues/2217">#2217</ref>).</item>

<item>The Jenkins image has been updated to fix the out of memory error (<ref
target="https://github.com/TEIC/TEI/issues/2239">#2239</ref>).</item>
</list>
</p>

<p>In addition, many improvements have been made to the XSLT stylesheets (which provide
processing of TEI ODD files for <ref target="https://romabeta.tei-c.org/">Roma</ref> and
<ref target="http://oxgarage.tei-c.org/">OxGarage</ref> as well as other TEI conversions).
The Stylesheets are maintained separately from the Guidelines at <ref
target="https://github.com/TEIC/Stylesheets">https://github.com/TEIC/Stylesheets</ref>. 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/Stylesheets/issues?q=is%3Aissue+milestone%3A%22Release+7.53.0%22+is%3Aclosed"
>7.53.0 milestone</ref>.</p>

<p>Highlights of this release include: <list>

<item>The location for pulling the <name type="file">p5subset.xml</name> in the file <name
type="file">tools/getnames.xsl</name> has been updated (<ref
target="https://github.com/TEIC/Stylesheets/issues/527">#527</ref>).</item>

<item>An incorrect namespace URI in the file <name type="file"
>html/html_figures.xsl</name> has been corrected (<ref
target="https://github.com/TEIC/Stylesheets/issues/546">#546</ref>). </item>

<!-- tbc -->

</list>
</p>

</body>
</text>
</TEI>

0 comments on commit 6f9fd2a

Please sign in to comment.