From e67ad3b24f60f78bc4f9dcfc060de8e73015330d Mon Sep 17 00:00:00 2001 From: Luther Tychonievich Date: Fri, 14 Jun 2024 12:28:16 -0500 Subject: [PATCH 1/5] Clarify nickname Add additional clarification to nickname, explaining the word's meaning in English which is not shared by several European countries. See [this comment](https://github.com/FamilySearch/GEDCOM/issues/473#issuecomment-2168463707) and the rest of issue #473 for more on why this clarification is needed. Although #473's discussion covers many more topics, if we go back to the title and first question in the issue I think this resolves #473. --- specification/gedcom-3-structures-3-meaning.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/specification/gedcom-3-structures-3-meaning.md b/specification/gedcom-3-structures-3-meaning.md index b67b20e..d9938a3 100644 --- a/specification/gedcom-3-structures-3-meaning.md +++ b/specification/gedcom-3-structures-3-meaning.md @@ -953,7 +953,9 @@ See also `INDIVIDUAL_ATTRIBUTE_STRUCTURE`. #### `NICK` (Nickname) `g7:NICK` -A descriptive or familiar name that is used instead of, or in addition to, one’s proper name. +A descriptive or familiar name that is used instead of, or in addition to, one’s official or legal name. +A nickname can be a derivation of another name, such as "Jimmy" fron "James", or a distinct name. +Nicknames can be brief-lived and informal or used consistently even in formal situations throughout one's life. #### `NMR` (Number of marriages) `g7:NMR` From 6e3c679f9f6bae8370484a60d8140c955a7828a4 Mon Sep 17 00:00:00 2001 From: Luther Tychonievich Date: Tue, 18 Jun 2024 13:11:46 -0500 Subject: [PATCH 2/5] Update specification/gedcom-3-structures-3-meaning.md --- specification/gedcom-3-structures-3-meaning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/gedcom-3-structures-3-meaning.md b/specification/gedcom-3-structures-3-meaning.md index d9938a3..b9a7458 100644 --- a/specification/gedcom-3-structures-3-meaning.md +++ b/specification/gedcom-3-structures-3-meaning.md @@ -954,7 +954,7 @@ See also `INDIVIDUAL_ATTRIBUTE_STRUCTURE`. #### `NICK` (Nickname) `g7:NICK` A descriptive or familiar name that is used instead of, or in addition to, one’s official or legal name. -A nickname can be a derivation of another name, such as "Jimmy" fron "James", or a distinct name. +A nickname can be a derivation of another name, such as "Jimmy" from "James", or a distinct name. Nicknames can be brief-lived and informal or used consistently even in formal situations throughout one's life. #### `NMR` (Number of marriages) `g7:NMR` From 968ba441ff1361c82e68382fbb1b52ebb3242625 Mon Sep 17 00:00:00 2001 From: Luther Tychonievich Date: Wed, 19 Jun 2024 11:27:43 -0500 Subject: [PATCH 3/5] Change recommendation --- specification/gedcom-3-structures-3-meaning.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/specification/gedcom-3-structures-3-meaning.md b/specification/gedcom-3-structures-3-meaning.md index b9a7458..127fe4e 100644 --- a/specification/gedcom-3-structures-3-meaning.md +++ b/specification/gedcom-3-structures-3-meaning.md @@ -954,8 +954,11 @@ See also `INDIVIDUAL_ATTRIBUTE_STRUCTURE`. #### `NICK` (Nickname) `g7:NICK` A descriptive or familiar name that is used instead of, or in addition to, one’s official or legal name. -A nickname can be a derivation of another name, such as "Jimmy" from "James", or a distinct name. -Nicknames can be brief-lived and informal or used consistently even in formal situations throughout one's life. + +:::note +Although the label of this structure is "nickname", the definition is limited to descriptive or familiar names, not to other name types sometimes called "nicknames" in English, such as names used in formal settings but not on legal documents. +However, some applications show users only the text "nickname", so user-entered `NICK` payloads that go beyond the structure's definition may be found in some GEDCOM files. +::: #### `NMR` (Number of marriages) `g7:NMR` From 63c3be756cb2b3a9e3832c67aa918dd8ff9cabe3 Mon Sep 17 00:00:00 2001 From: Luther Tychonievich Date: Tue, 2 Jul 2024 13:08:57 -0500 Subject: [PATCH 4/5] Update specification/gedcom-3-structures-3-meaning.md --- specification/gedcom-3-structures-3-meaning.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/specification/gedcom-3-structures-3-meaning.md b/specification/gedcom-3-structures-3-meaning.md index f278cd7..98a137f 100644 --- a/specification/gedcom-3-structures-3-meaning.md +++ b/specification/gedcom-3-structures-3-meaning.md @@ -963,8 +963,11 @@ See also `INDIVIDUAL_ATTRIBUTE_STRUCTURE`. A descriptive or familiar name that is used instead of, or in addition to, one’s official or legal name. :::note -Although the label of this structure is "nickname", the definition is limited to descriptive or familiar names, not to other name types sometimes called "nicknames" in English, such as names used in formal settings but not on legal documents. -However, some applications show users only the text "nickname", so user-entered `NICK` payloads that go beyond the structure's definition may be found in some GEDCOM files. +The title and description of this structure was introduced with version 5.5 in 1996, but are understood differently by different users. +Some use NICK only for names that would be inappropriate in formal settings. +Some use it for pseudonyms regardless of where they are used. +Some use it for any variant of a name that is not the one used on legal documents +Because all of these uses, and likely others as well, are common in existing data, no further clarification of the meaning of the NICK structure is possible without contradicting some existing data. ::: #### `NMR` (Number of marriages) `g7:NMR` From cd2d171cc001184e6639374cfb60c9e4948d5897 Mon Sep 17 00:00:00 2001 From: Luther Tychonievich Date: Tue, 2 Jul 2024 13:12:30 -0500 Subject: [PATCH 5/5] Update specification/gedcom-3-structures-3-meaning.md --- specification/gedcom-3-structures-3-meaning.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/gedcom-3-structures-3-meaning.md b/specification/gedcom-3-structures-3-meaning.md index 98a137f..cea6449 100644 --- a/specification/gedcom-3-structures-3-meaning.md +++ b/specification/gedcom-3-structures-3-meaning.md @@ -963,11 +963,11 @@ See also `INDIVIDUAL_ATTRIBUTE_STRUCTURE`. A descriptive or familiar name that is used instead of, or in addition to, one’s official or legal name. :::note -The title and description of this structure was introduced with version 5.5 in 1996, but are understood differently by different users. -Some use NICK only for names that would be inappropriate in formal settings. +The label "nickname" and description text of this structure were introduced with version 5.5 in 1996, but are understood differently by different users. +Some use `NICK` only for names that would be inappropriate in formal settings. Some use it for pseudonyms regardless of where they are used. -Some use it for any variant of a name that is not the one used on legal documents -Because all of these uses, and likely others as well, are common in existing data, no further clarification of the meaning of the NICK structure is possible without contradicting some existing data. +Some use it for any variant of a name that is not the one used on legal documents. +Because all of these uses, and likely others as well, are common in existing data, no further clarification of the meaning of the `NICK` structure is possible without contradicting some existing data. ::: #### `NMR` (Number of marriages) `g7:NMR`