[tei-council] 2.0 release notes
gabriel.bodard at kcl.ac.uk
Wed Dec 14 08:34:52 EST 2011
I've tried to compose such a brief paragraph, but (a) it's not brief,
and (b) I'm not sure whether it says too much or not enough. Anybody
like to propose a way to make it more concise?
<item>A major revision of the <gi>subst</gi> element content model has
been made, to bring the schema and guidelines in line with what we
believe to be good practice for this element (the only legal contents of
<gi>subst</gi> are now <gi>del</gi>, <gi>add</gi>). This may result in
some projects' existing XML becoming invalid under the new schema, but
(a) these projects were already dubious in practice, and (b) new
functionality has been introduced in the form of the <gi>substJoin</gi>
element to cater for the more problematic substitutions that required
the deprecated markup.</item>
On 2011-12-13 16:27, Martin Holmes wrote:
> This should definitely go in the readme, then -- could you add a brief
> paragraph to it?
> On 11-12-13 07:35 AM, Gabriel Bodard wrote:
>> One exception to this: the changes we made to subst *will* invalidate
>> existing documents, but only if those documents followed the schema and
>> ignored good practice. People should be warned, though.
>> On 2011-12-12 22:49, Lou Burnard wrote:
>>> I've just checked into the P5 repository a preliminary draft for the
>>> release notice to go out with release 2.0 of TEI P5, due real soon now.
>>> I just picked out a few of what I see as the key developments, and would
>>> much welcome suggestions for things I've overlooked or misrepresented.
>>> The authoritative version is at P5/ReleaseNotes/readme-2.0.xml and it
>>> looks like this:
>>> This is a major new release of the P5 Guidelines, which introduces some
>>> significant new material as well as implementing an unusually large set
>>> of other changes and error corrections. Since the last release in March
>>> 2011, members of the TEI community have proposed over 60 feature
>>> requests and reported about the same number of errors; dealing with
>>> these has kept the TEI Council busy, and most of these tickets have now
>>> been closed. Discussion of each modification and each action taken is
>>> available on the relevant sourceforge ticket, which is also referenced
>>> in the change log, as usual.
>>> We mention here just a few of the more notable changes in this release:
>>> 1 Several new elements have been introduced to facilitate a more
>>> "document-focussed" (as opposed to "text-focussed") way of working. A
>>> new document element can now be used to organize digital images of a
>>> source document in much the same way as the existing facsimile, but with
>>> the added ability to embed detailed source transcriptions of the source
>>> within the same structure. A number of other elements have been added or
>>> modified to support the detailed encoding of transcriptions of
>>> individual documents, and a mechanism has been defined for the encoder
>>> to represent the evolution of a text through various writing stages. The
>>> existing chapter on Physical Transcription has been exhaustively revised
>>> to cater for these revisions which will, it is hoped, go some way to
>>> improve the support offered by the TEI scheme for documentary and
>>> genetic editing.
>>> 2. The licensing conditions applicable to TEI products were made more
>>> explicit and evident; the source code tree was tidied up, with all
>>> unused items being moved out; some old annoyances -- notably the
>>> meaningless distinction between "mwa" and "opt" -- were removed
>>> 3 A new notatedMusic element was added to support representation of
>>> musical notation within texts in a way compatible with the existing
>>> Music XML standard.
>>> 4. A number of minor changes were made to make it possible to represent
>>> dates, and normalised dates, using non-Julian calendar systems; a new
>>> attribute class was defined to facilitate provision of sort keys.
>>> 5. Several modifications were made to enhance the representation of more
>>> carefully structured or richer bibliographic entries, notably the
>>> ability to nest one bibl within another, and the ability to specify a
>>> work's language.
>>> 6. All examples were revised to drastically reduce the amount of
>>> unnecessarily divergent and encoding practices (such as the values used
>>> for the @rend attribute, or for language identifier codes)
>>> 7. The content models of some elements were relaxed in light of the
>>> experience of converting ECCO to TEI P5, to permit for example stage
>>> directions within verse, or verse within headings.
>>> As far as possible, and in line with stated policy, none of the changes
>>> made at this release should invalidate existing documents. Rather than
>>> simply removing features or practices which are now considered
>>> erroneous, care has been taken to indicate that such features are
>>> deprecated and may be removed at a subsequent release. Work is ongoing
>>> on how exactly to formalise this policy.
Dr Gabriel BODARD
(Research Associate in Digital Epigraphy)
Department of Digital Humanities
King's College London
26-29 Drury Lane
London WC2B 5RL
Email: gabriel.bodard at kcl.ac.uk
Tel: +44 (0)20 7848 1388
Fax: +44 (0)20 7848 2980
More information about the tei-council