From 44106e7d9761e16e04376786a9165f49f4d85b45 Mon Sep 17 00:00:00 2001 From: Dave Thaler Date: Tue, 8 Oct 2024 09:00:25 -0700 Subject: [PATCH 1/4] Add note about blank payloads Based on discussion in issue #495 Signed-off-by: Dave Thaler --- specification/gedcom-3-structures-1-organization.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/specification/gedcom-3-structures-1-organization.md b/specification/gedcom-3-structures-1-organization.md index a153daae..fcf9e3e4 100644 --- a/specification/gedcom-3-structures-1-organization.md +++ b/specification/gedcom-3-structures-1-organization.md @@ -1138,6 +1138,14 @@ A place, which can be represented in several ways: or in the `HEAD`.`PLAC`.`FORM` if there is no `FORM` substructure. 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. +:::note + Existing applications often default to assuming a `FORM` of "City, County, State, Country", + and may even ignore any `FORM` substructures and treat payloads with a smaller number of + elements as if they had additional blank elements at the end. Accordingly, to increase + the chances of interoperability it is recommended that blank elements be used to ensure + payloads can be interpreted as best as possible in such a circumstance. +::: + Elements should be left blank if they are unknown, do not apply to the location, or are too specific for the region in question.
From 449a136f6750ab42774c9cc94f3ef199ee314a35 Mon Sep 17 00:00:00 2001 From: Dave Thaler Date: Tue, 8 Oct 2024 09:26:24 -0700 Subject: [PATCH 2/4] Update specification/gedcom-3-structures-1-organization.md --- specification/gedcom-3-structures-1-organization.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/gedcom-3-structures-1-organization.md b/specification/gedcom-3-structures-1-organization.md index fcf9e3e4..d4c13a0e 100644 --- a/specification/gedcom-3-structures-1-organization.md +++ b/specification/gedcom-3-structures-1-organization.md @@ -1140,7 +1140,7 @@ A place, which can be represented in several ways: :::note Existing applications often default to assuming a `FORM` of "City, County, State, Country", - and may even ignore any `FORM` substructures and treat payloads with a smaller number of + and some even ignore any `FORM` substructures and treat payloads with a smaller number of elements as if they had additional blank elements at the end. Accordingly, to increase the chances of interoperability it is recommended that blank elements be used to ensure payloads can be interpreted as best as possible in such a circumstance. From d9ba22133fa997cd10345c4b6172e3d345c2cc10 Mon Sep 17 00:00:00 2001 From: Dave Thaler Date: Tue, 8 Oct 2024 09:37:01 -0700 Subject: [PATCH 3/4] Update specification/gedcom-3-structures-1-organization.md --- specification/gedcom-3-structures-1-organization.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/specification/gedcom-3-structures-1-organization.md b/specification/gedcom-3-structures-1-organization.md index d4c13a0e..f97d604f 100644 --- a/specification/gedcom-3-structures-1-organization.md +++ b/specification/gedcom-3-structures-1-organization.md @@ -1139,11 +1139,9 @@ A place, which can be represented in several ways: 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. :::note - Existing applications often default to assuming a `FORM` of "City, County, State, Country", - and some even ignore any `FORM` substructures and treat payloads with a smaller number of - elements as if they had additional blank elements at the end. Accordingly, to increase - the chances of interoperability it is recommended that blank elements be used to ensure - payloads can be interpreted as best as possible in such a circumstance. + Some applications and users have defaulted to assuming a `FORM` of "City, County, State, Country", + and some applications even ignore any `FORM` substructures and treat payloads with a smaller number of + elements as if they had additional blank elements at the end. ::: Elements should be left blank if they are unknown, do not apply to the location, or are too specific for the region in question. From b4cc7b5eb130c5b70b028d8ec16d2d98b6c2d825 Mon Sep 17 00:00:00 2001 From: Dave Thaler Date: Tue, 8 Oct 2024 09:37:57 -0700 Subject: [PATCH 4/4] Update specification/gedcom-3-structures-1-organization.md --- specification/gedcom-3-structures-1-organization.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/gedcom-3-structures-1-organization.md b/specification/gedcom-3-structures-1-organization.md index f97d604f..bdea3ed3 100644 --- a/specification/gedcom-3-structures-1-organization.md +++ b/specification/gedcom-3-structures-1-organization.md @@ -1138,11 +1138,11 @@ A place, which can be represented in several ways: or in the `HEAD`.`PLAC`.`FORM` if there is no `FORM` substructure. 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. -:::note +
Some applications and users have defaulted to assuming a `FORM` of "City, County, State, Country", and some applications even ignore any `FORM` substructures and treat payloads with a smaller number of elements as if they had additional blank elements at the end. -::: +
Elements should be left blank if they are unknown, do not apply to the location, or are too specific for the region in question.