Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Major revision] Restructuring (<archguide>, <desc>, <identity>, <repositories>, <repositiory>) #87

Closed
kerstarno opened this issue Feb 9, 2022 · 1 comment
Labels
Conversion change This requires a change in the conversion Major revision This is a feature request which will be dealt with in a major revision of the EAG2012 standard

Comments

@kerstarno
Copy link
Contributor

Provide a general summary of the issue in the Title above.

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: <archguide> - Archival guide, <desc> - Description, <identity> - Identity, <repositories> - Repositories, <repository> - Repository

Link to related schema change issue

Provide the link to the schema change issue for the element / attribute.
Issue: #82, #83, #84, #85, #86

Detailed conversion changes

Summarise all steps to be applied to the element / attribute in question: changes in the tag name, context and availability, sub-elements to be removed or added (in case of new mandatory sub-elements), attributes (with their values, if applicable and of importance for the conversion path) to be removed or added (in case of new mandatory attributes).
Summary of changes:

  • Move <repositories> out of <desc> and add it to <eag> instead
  • Add <repository> as a parallel element to <repositories> in <eag>
    • In <eag>, there will be a choice between either one (not repeatable) <repository> or a <repositories> wrapper element including at least two <repository> sub-elements
  • Move sub-elements of <repository> into <desc>
  • Move <desc> and <identity> out of <archguide> and into <repository>
    • Rename <desc> to <description> in this context
  • Remove <archguide>

Example

Provide an example snippet of the current element (with all relevant sub-elements and attributes) and the expected conversion result.
Example:

Current encoding

<eag>
   <control>
      [...]
   </control>
   <archguide>
      <identity>
         [...]
      </identity>
      <desc>
         <repositories>
            <repository>
               [sub-elements of repository]
            </repository>
         </repositories>
      </desc>
   </archguide>
</eag>

or

<eag>
   <control>
      [...]
   </control>
   <archguide>
      <identity>
         [...]
      </identity>
      <desc>
         <repositories>
            <repository>
               [sub-elements of repository]
            </repository>
            <repository>
               [sub-elements of repository]
            </repository>
         </repositories>
      </desc>
   </archguide>
</eag>

Expected encoding

<eag>
   <control>
      [...]
   </control>
   <repository>
      <identity>
         [...]
      </identity>
      <description>
         [sub-elements of former repository]
      </description>
   </repository>
</eag>

or

<eag>
   <control>
      [...]
   </control>
   <repositories>
      <repository>
         <identity>
            [...]
         </identity>
         <description>
            [sub-elements of first former repository]
         </description>
      </repository>
      <repository>
         <identity>
            [... - use content of <repositoryName> within second former repository to create <nameEntry><part>]
         </identity>
         <description>
            [sub-elements of second former repository]
         </description>
      </repository>
   </repositories>
</eag>
@kerstarno kerstarno added Conversion change This requires a change in the conversion Major revision This is a feature request which will be dealt with in a major revision of the EAG2012 standard labels Feb 9, 2022
@kerstarno
Copy link
Contributor Author

Incorporated in #35.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Conversion change This requires a change in the conversion Major revision This is a feature request which will be dealt with in a major revision of the EAG2012 standard
Projects
None yet
Development

No branches or pull requests

1 participant