Skip to content

Add note about empty place levels #495

@dthaler

Description

@dthaler

The discussion of <g7:PLAC> says:

The principal place in which the superstructure’s subject occurred, represented as a List of jurisdictional entities in a sequence from the lowest to the highest jurisdiction. As with other lists, the jurisdictions are separated by commas. Any jurisdiction’s name that is missing is still accounted for by an empty string in the list.

The type of each jurisdiction is given in the PLAC.FORM substructure, if present, or in the HEAD.PLAC.FORM structure. If neither is present, the jurisdictional types are unspecified beyond the lowest-to-highest order noted above.

The sentence "Any jurisdiction’s name that is missing is still accounted for by an empty string in the list." is somewhat counter-intuitive. That is, the reader wonders: why would one not just remove that level from PLAC.FORM and omit the empty level?

For example, why have:

3 PLAC , Oneida, Idaho, USA
4 FORM City, County, State, Country

instead of:

3 PLAC Oneida, Idaho, USA
4 FORM County, State, Country

which certainly makes for smaller files? This seems to warrant a note at least.

Some possible cases to consider:

  • PLAC.FORM is absent and the HEAD.FORM has "City, County, State, Country", but then why not recommend adding PLAC.FORM?. OR,
  • PLAC.FORM is absent and HEAD.FORM is absent and app defaults are "City, County, State, Country". But relying on that being the default in all apps is error prone and certainly not implied by the spec, so using FORM should be recommended instead, and PR Clarify no-FORM PLACs #487 explicitly adds "If neither FORM exists, the meaning of the elements are not defined in this specification beyond being names of jurisdictions of some kind, ordered from smallest to largest." OR,
  • PLAC.FORM and/or HEAD.FORM are present, but the reading app does not understand FORM and so ignores it. But this is similar to them being absent, and the spec contains no mention of apps defaulting to 4 levels.

In short, the spec contains no rationale for why having an empty level at the beginning of a PLAC would be good behavior. Perhaps making no recommendation either way is ok, but I think at least a note would improve clarity. Maybe a technical FAQ discussion with several examples might also be appropriate.

Other examples to consider:

  • An independent city exists in a state, and there is no county, e.g., Virginia Beach, Virginia, USA
2 PLAC Virginia Beach, Virginia, USA
3 FORM City, State, Country

vs

2 PLAC Virginia Beach, , Virginia, USA
3 FORM City, County, State, Country
  • A place was recorded but it is unknown which of several jurisdictions was meant, e.g., Salem, OR or Salem, MA or...?
2 PLAC Salem
3 FORM City

vs

2 PLAC Salem, , ,
3 FORM City, County, State, Country

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions