Skip to content

Commit 44106e7

Browse files
committed
Add note about blank payloads
Based on discussion in issue FamilySearch#495 Signed-off-by: Dave Thaler <[email protected]>
1 parent f17281b commit 44106e7

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

specification/gedcom-3-structures-1-organization.md

+8
Original file line numberDiff line numberDiff line change
@@ -1138,6 +1138,14 @@ A place, which can be represented in several ways:
11381138
or in the `HEAD`.`PLAC`.`FORM` if there is no `FORM` substructure.
11391139
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.
11401140

1141+
:::note
1142+
Existing applications often default to assuming a `FORM` of "City, County, State, Country",
1143+
and may even ignore any `FORM` substructures and treat payloads with a smaller number of
1144+
elements as if they had additional blank elements at the end. Accordingly, to increase
1145+
the chances of interoperability it is recommended that blank elements be used to ensure
1146+
payloads can be interpreted as best as possible in such a circumstance.
1147+
:::
1148+
11411149
Elements should be left blank if they are unknown, do not apply to the location, or are too specific for the region in question.
11421150

11431151
<div class="example">

0 commit comments

Comments
 (0)