[Major revision] Updates to <maintenanceHistory>, <maintenanceEvent> and its sub-elements

Provide a general summary of the issue in the Title above. Delete the part of the issue template that does not apply depending on whether you describe a change to an existing element / attribute or the addition of a new one.

Creator of issue

State your name, organisation and ways to reach you. Name: Kerstin Arnold Organisation: Archives Portal Europe Foundation, Working Group on Standards Email: standards@archivesportaleurope.net GitHub username (if applicable): @kerstarno

Changes to existing element / attribute

Give the current name of the element / attribute. Include the tag name and the full name. Name: <maintenanceHistory>, <maintenanceEvent>, <agent>, <agentType>, <eventType>, and <eventDateTime>

Change in content model (elements)

List all sub-elements and attributes that should be removed from or added to the element's content model.

In EAG 2012, <maintenanceHistory> requires at least one <maintenanceEvent>, which can be used repeatedly. <maintenanceHistory> does not have any attributes. <maintenanceEvent> has the optional attribute @xml:lang and the required and not repeatable sub-elements <agent>, <agentType>, <eventType>, and <eventDateTime>.
In alignment with EAC-CPF and EAD, the following changes will be applied:
- <maintenanceHistory> allows for the attributes @audience (0) with values "external" and "internal", @id (0), @languageOfElement(0), @scriptOfElement (0), @target (0), and the option to include attributes from any other namespace.
- The element <agentType> is removed from <maintenanceEvent> and an attribute @agentType is added as required to <agent>. In addition to the existing values "human" and "machine", @agentType can also have the value "unknown".
- The element <eventType> is removed from <maintenanceEvent> and the required attribute @maintenanceEventType is added to <maintenanceEvent> instead. The value "published" is removed without a replacement, while a new value "unknown" is added.
- When converted from EAG 2012 to EAG 3.0, "published" is to be replaced by "updated", seeing that @maintenanceEventType has to be there, and an <eventDescription> is to be added saying "published".
- The element <eventDescription> is added to <maintenanceEvent> as optional and repeatable; <eventDescription> itself allows for text and for the sub-elements <reference> (0..n) and <span> (0..n) and the attributes @audience (0) with values "external" and "internal", @id (0), @languageOfElement(0), @scriptOfElement (0), @target (0), and the option to include attributes from any other namespace.
- Apart from the addition of the required attribute @agentType, the attributes @xml:lang and @source are removed from <agent> and the attributes @audience (0) with values "external" and "internal", @id (0), @languageOfElement(0), @scriptOfElement (0), @target (0), @valueURI (0), @vocabularySource (0), @vocabularySourceURI (0) and the option to include attributes from any other namespace are added.
- For the sub-element <eventDateTime>, the @source attribute is removed without replacement and the attributes @audience (0) with values "external" and "internal", @id (0), @languageOfElement(0), @scriptOfElement (0), @target (0), and the option to include attributes from any other namespace are added. Furthermore, the restriction for the attribute @standardDateTime only to include dates before 31 December 9999 (see #40) is lifted completely.

For conversion, the current encoding

<maintenanceHistory>
  <maintenanceEvent xml:lang="language of maintenanceEvent">
    <agent xml:lang="language of agent" source="source of agent">Agent</agent>
    <agentType>human OR machine</agentType>
    <eventDateTime source="source of eventDateTime" standardDateTime="YYYY-MM-DDTHH:MM:SS">
    eventDateTime</eventDateTime>
    <eventType>cancelled OR created OR deleted OR derived OR published OR revised OR updated</eventType>
  </maintenanceEvent>
</maintenanceHistory>

becomes

<maintenanceHistory>
  <maintenanceEvent languageOfElement="language of maintenanceEvent" maintenanceEventType="cancelled OR created OR deleted OR derived OR revised OR updated">
    <agent agentType="human OR machine" languageOfElement="language of agent" vocabularySource="source of agent">Agent</agent>
    <eventDateTime standardDateTime="YYYY-MM-DDTHH:MM:SS">eventDateTime</eventDateTime>
    <!-- if the <eventType> was "published", the @maintenanceEventType "updated" is used and an <eventDescription> is added as follows
    <eventDescription>published</eventDescription>
    -->
  </maintenanceEvent>
</maintenanceHistory>

ArchivesPortalEuropeFoundation / EAG2012