[Major revision] Updates to <maintenanceAgency> 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: <maintenanceAgency> with <agencyCode>, <agencyName>, <otherAgencyCode>, and <descriptiveNote>

Change in content model (elements)

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

<maintenanceAgency> is a required, not repeatable sub-element of <control>. In EAG 2012, it requires <agencyCode> and <agencyName>, both being not repeatable, and allows for an optional and repeatable <otherAgencyCode> and an optional, not repeatable <descriptiveNote>. In EAG 2012, <maintenanceAgency> does not include any attributes.
To align with EAC-CPF and EAD, <maintenanceAgency> in EAG 3.0 requires EITHER <agencyCode>, OR <agencyName> to be present. If both are present, <agencyCode> needs to be listed first. Furthermore, <agencyName> is made repeatable (e.g. to provide the name of the agency in various languages). The set-up for <otherAgencyCode> and <descriptiveNote> remains the same. Last, the attributes @countryCode (0), @audience with values "external" or "internal" (0), @id (0), languageOfElement (0), @scriptOfElement (0), @valueURI (0), @vocabularySource(0), @vocabularySourceURI (0), and an option to add attributes from any other namespace are added to <maintenanceAgency>.
For <agencyCode>, the attribute @source is removed and the attributes @status with values "authorized", "alternative" (0), @audience with values "external", "internal" (0), @id (0), @languageOfElement (0), @scriptOfElement (0), @target (0), @valueURI (0), @vocabularySource (0), @vocabularySourceURI (0) and an option to include attributes from any other namespace are added.
For <agencyName>, the attributes @xml:lang and @source are removed and the attributes @audience with values "external", "internal" (0), @id (0), @languageOfElement (0), @scriptOfElement (0), @target (0), @valueURI (0), @vocabularySource (0), @vocabularySourceURI (0) and an option to include attributes from any other namespace are added.
For <otherAgencyCode>, the attribute @source is removed and the attributes @status with values "authorized", "alternative" (0), @audience with values "external", "internal" (0), @id (0), @languageOfElement (0), @scriptOfElement (0), @target (0), @localTypeDeclarationReference (0), @valueURI (0), @vocabularySource (0), @vocabularySourceURI (0) and an option to include attributes from any other namespace
For <descriptiveNote>, the attributes @audience with values "external", "internal" (0), @id (0), @languageOfElement (0), @scriptOfElement (0), @target (0), @conventionDeclarationReference (0), @mainteancenEventReference (0), @sourceReference (0) and an option to include attributes from any other namespace are added.
- For <p> within <descriptiveNote>, the sub-elements <reference> (0..n) and <span> (0..n) are added next to the option of including text in <p> directly, the attributes @xml:lang and @source are removed and the attributes @audience with values "external", "internal" (0), @id (0), @languageOfElement (0), @scriptOfElement (0), @target (0), @conventionDeclarationReference (0), @mainteancenEventReference (0), @sourceReference (0) and an option to include attributes from any other namespace are added.

For conversion, the current encoding

<maintenanceAgency>
  <agencyCode source="source of agencyCode">agencyCode</agencyCode>
  <agencyName xml:lang="language of agencyName" source="source of agencyName">agencyName</agencyName>
  <otherAgencyCode localType="localType of otherAgencyCode 1" source="source of otherAgencyCode 1">otherAgencyCode 1</otherAgencyCode>
  <otherAgencyCode localType="localType of otherAgencyCode 2" source="source of otherAgencyCode 2">otherAgencyCode 2</otherAgencyCode>
  <descriptiveNote>
    <p xml:lang="language of p 1" source="source of p1">p1</p>
    <p xml:lang="language of p 2" source="source of p2">p2</p>
  </descriptiveNote>
</maintenanceAgency>

becomes

<maintenanceAgency>
  <agencyCode vocabularySource="source of agencyCode">agencyCode</agencyCode>
  <agencyName languageOfElement="language of agencyName" vocabularySource="source of agencyName">agencyName</agencyName>
  <otherAgencyCode localType="localType of otherAgencyCode 1" vocabularySource="source of otherAgencyCode 1">otherAgencyCode 1</otherAgencyCode>
  <otherAgencyCode localType="localType of otherAgencyCode 2" vocabularySource="source of otherAgencyCode 2">otherAgencyCode 2</otherAgencyCode>
  <descriptiveNote>
    <p languageOfElement="language of p 1" sourceReference="#source1">p1</p>
    <p languageOfElement="language of p 2" sourceReference="#source2">p2</p>
  </descriptiveNote>
</maintenanceAgency>
[...]
<sources>
  <source id="source1">
    <reference>source of p1</reference>
  </source>
  <source id="source2">
    <reference>source of p2</reference>
  </source>
</sources>

ArchivesPortalEuropeFoundation / EAG2012