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

Review div subtype values not enumerated in frus.sch #299

Closed
joewiz opened this issue Jan 7, 2022 · 4 comments
Closed

Review div subtype values not enumerated in frus.sch #299

joewiz opened this issue Jan 7, 2022 · 4 comments
Assignees

Comments

@joewiz
Copy link
Member

joewiz commented Jan 7, 2022

The frus.sch Schematron file enumerates the allowed values for div/@subtype values. The list there is drawn from the values that are in the XSL scripts that enrich divs with @subtype values.

A query of volumes shows that we have made use of several additional values; here are the values and the number of instances of each in the corpus:

  1. chapter-introduction (8)
  2. errata_document-numbering-error (2)
  3. event (38)
  4. graphic-materials (10)
  5. note-on-covert-actions (39)
  6. section (2)
  7. subsection (85)
  8. undetermined (3)

The following XPath leads to the individual instances and can be run in oXygen's XPath toolbar:

//div[@subtype and not(@subtype = ('about-frus-series', 'acknowledgements', 'additional-volumes', 'appendix', 'editorial-note', 'editorial-policies', 'errata', 'historian-statement', 'historical-document', 'index', 'maps', 'notes', 'preface', 'press-release', 'referral', 'sources', 'table-of-contents', 'volume-summary'))]

For each of these values we need to either (a) add the value to the list of allowed @subtype values or (b) update the value to be one of the allowed values.

@WaxCylinderRevival WaxCylinderRevival self-assigned this Jan 7, 2022
@WaxCylinderRevival
Copy link
Member

WaxCylinderRevival commented Jan 7, 2022

(Note: related issue #199)

@WaxCylinderRevival
Copy link
Member

WaxCylinderRevival commented Jan 7, 2022

As of January 7, 2021:

Current @subtype value frequency
about-frus-series 39
acknowledgements 2
additional-volumes 39
appendix 19
editorial-note 8,495
editorial-policies 4
errata 54
graphic-materials 0
historical-document 301,681
index 1,225
maps-and-charts 11
note-on-covert-actions 44
preface 396
press-release 52
referral 979
section 15
sources 251
subsection 110
table-of-contents 467
volume-summary 25

Deprecated

  • chapter-introduction
  • errata_document-numbering-error
  • event
  • historian-statement
  • maps
  • notes
  • related-materials
  • undetermined

@WaxCylinderRevival
Copy link
Member

WaxCylinderRevival commented Jan 11, 2022

As of January 10, 2021:

Current @subtype value Definition Part of Volume Current Frequency
about-frus-series Brief section introducing the Foreign Relations of the United States series and its regulations and statutory history. Typically found in front matter. 39
acknowledgments Statement acknowledging contributions of others, often including Office of the Historian staff members and archival staff at record repositories. Typically found in front matter. 2
additional-volumes A listing or reference to other volumes dealing with similar topics of the time period or the same Presidential administration. Typically found in front matter. 39
appendix Section of supplementary material usually attached at the end of the volume. Typically found in back matter. 19
editorial-note Documents written entirely by the compiler, with selected quotations as appropriate from original historical documents. Typically found in the body of the volume. 8,495
editorial-policies Principles of document selection for the Foreign Relations series. Typically found in front matter. 4
errata A list of corrected errors discovered after printing and appended to the volume. Typically found in back matter. 55
foreword An introductory section typically authored by a person other than the primary compiler, often the General Editor. Typically found in front matter. 5
graphic-material Includes visual artwork, prints, and photographs. Typically found in back matter. 0
historical-document Original record, often in the form of reports, cables, telegrams, correspondence, memoranda, meeting minutes, speeches, transcripts, articles, or other source material. Historical documents may be included in the volume in part or in full. Typically found in the body of the volume. 301,681
index Includes indices, list of papers, list of persons, and list of organizations. Typically found in front matter and back matter. 1,225
map-or-chart Includes maps (representation of an area of land, sea, or other place, often showing physical features, cities, roads, etc.) and charts (graphical representation of data). Typically found in back matter. 11
note-on-covert-actions Note providing readers with some organizational context on how covert actions and special intelligence operations in support of U.S. foreign policy were planned and approved within the U.S. Government. Typically found in front matter. 44
preface An introduction to a volume typically authored by the primary compiler. Typically found in front matter. 396
press-release An official statement issued to media and the public regarding the release of the volume. Typically found in front matter. 52
referral See reference to another portion of the same volume or a different volume in lieu of document text. Typically found in the body of the volume. 979
section Component of the volume not otherwise categorized. In the body of the volume, section may appear as textual division that is a hierarchical child of a compilation, chapter, subchapter, or document; may include subsections. May appear in the front matter, back matter, and body of the volume. 15
sources Important archival collections and files as well as published works used as source material in the research and compilation of the volume. Typically found in front matter. 251
subsection Component of the volume that is a hierarchical child of a section. Typically found in the body of the volume. 110
table-of-contents A list of the book components [such as compilations, chapters, or sections] given at the front of the volume. Typically found in front matter. 467
volume-summary Summary of the most important of the issues covered in the volume. Typically found in front matter. 24

Deprecated

  • chapter-introduction
  • errata_document-numbering-error
  • event
  • historian-statement
  • maps
  • notes
  • related-materials
  • undetermined

@joewiz
Copy link
Member Author

joewiz commented Jan 18, 2022

Closed by #300

@joewiz joewiz closed this as completed Jan 18, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants