diff --git a/attribute-event-requests/FAM-attribute.md b/attribute-event-requests/FAM-attribute.md index b3773df3..2c0a7131 100644 --- a/attribute-event-requests/FAM-attribute.md +++ b/attribute-event-requests/FAM-attribute.md @@ -7,39 +7,40 @@ Guides for using this document can be found in the associated [README.md](README | G7 Tag | Since | Name | Notes | |:------:|-------|------|-------| -| \* | 5.0 | [Childless](#childless) | encoded as `NCHI 0` | -| | | [Lived Together](#lived-together) | perhaps `RESI`? | -| `NCHI` | 5.0 | Number of children | | -| `RESI` | 3.0 | Residence | | - +| \* | 5.0 | [Childless](#childless) | encoded as `NCHI 0` | +| \* | Proposed | [Lived Together](#lived-together) | perhaps `RESI` | +| `NCHI` | 5.0 | [Number of Children](#number-of-children) | | +| `RESI` | 3.0 | [Residence](#residence) | | # Details - +-------------------------- ## Childless - +### Description The assertion that a family does not have children can be made using the `NCHI` structure with payload "`0`". This is distinct from simply not having any `CHIL` structures, which might mean there are children that have not yet been added to the data. -### Used +### Value -- Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as a distinct stucture with URI `http://familysearch.org/v1/CoupleNeverHadChildren` -## Lived together +### Absence +encoded as `NCHI 0` -### Description +### Used +- Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as a distinct structure with URI `http://familysearch.org/v1/CoupleNeverHadChildren` +-------------------------- +## Lived Together +### Description *proposed description missing* *In [FamilySearch API documentation](https://www.familysearch.org/developers/docs/guides/facts)* without a definition ### Value - Found in the following historical records: - (records not yet identified) ### Absence - The most closely related structures are: - `FAM`.`RESI`: provides the place of residence for the couple, which generally implies they lived together. However, "lived together" is sometimes used as a euphemism for "acted as a couple without a preceding marriage ceremony," which is only indirectly implied by the presence of a `FAM`.`RESI`. @@ -49,7 +50,35 @@ Related proposals include - Common Law Marriage (in the Family Events document): some interpretations of common law marriage and cohabitation are very similar to one another +### Used +- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/LivedTogether` + +-------------------------- +## Number of Children +### Description + + +### Value + + +### Absence + ### Used -- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/LivedTogether` + +-------------------------- +## Residence +### Description +An address or place of residence where an individual resided. + +### Value + + +### Absence + + +### Used + + +-------------------------- diff --git a/attribute-event-requests/FAM-event.md b/attribute-event-requests/FAM-event.md index da9c3049..2eb9d6a3 100644 --- a/attribute-event-requests/FAM-event.md +++ b/attribute-event-requests/FAM-event.md @@ -7,57 +7,191 @@ Guides for using this document can be found in the associated [README.md](README | G7 Tag | Since | Name | Notes | |:------:|-------|------|-------| -| `ANUL` | 4.0 | [Annulment](#annulment) | | -| `CENS` | 3.0 | Census | | -| | | [Common Law Marriage](#common-law-marriage) | perhaps `MARR`.`TYPE Common law`? | -| `DIV` | 3.0 | [Divorce](#divorce) | | -| `DIVF` | 4.0 | Divorce Filed | | -| `ENGA` | 4.0 | Engagement | | -| `MARR` | 3.0 | [Marriage](#marriage) | | -| `MARB` | 4.0 | Marriage Bann | | -| `MARL` | 4.0 | Marriage License | | -| `MARS` | 4.0 | Marriage Settlement | | - +| `ANUL` | 4.0 | [Annulment](#annulment) | | +| `CENS` | 3.0 | [Census](#census) | | +| | Proposed | [Child Recognition](#child-recognition) | | +| \* | Proposed | [Common Law Marriage](#common-law-marriage) | see `MARR.TYPE` definition | +| `DIV` | 3.0 | [Divorce](#divorce) | | +| `DIVF` | 4.0 | [Divore Filed](#divore-filed) | | +| `ENGA` | 4.0 | [Engagement](#engagement) | | +| `MARR` | 3.0 | [Marriage](#marriage) | | +| `MARB` | 4.0 | [Marriage Bann](#marriage-bann) | Is this similar to engagement announcement. | +| `MARL` | 4.0 | [Marriage License](#marriage-license) | | +| `MARS` | 4.0 | [Marriage Settlement](#marriage-settlement) | | # Details - +-------------------------- ## Annulment +### Description +Declaring a marriage void from the beginning (never existed). -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Annulment` +### Value -## Common Law Marriage +### Absence + + +### Used +*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/event-types-specification.md)* with URI `http://gedcomx.org/Annulment` + +-------------------------- +## Census ### Description +Periodic count of the population for a designated locality, such as a national or state census. + +### Value + + +### Absence + + +### Used +*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/event-types-specification.md)* with `URI http://gedcomx.org/Census` + +-------------------------- +## Child Recognition +### Description +A legal action which grants a parent-child relationship between a child and a parent; often as part of legitimizing a step-parent relationship or as legal recognition of a biological relationship that was not recognized at the time of birth. + +### Value +Found in the following historical records + +- As "reconnaissance d'enfant" in legal registries in France +- As "Legitimation" in legal registries in Germany + +### Absence +The most closely related structures are: + +- `ADOP`: both events establish a legal parent relationship after birth. In some countries they are the same as one another; in other countries they have different criteria and/or legal ramifications. +### Used +Applications using this structure have not yet been identified. + +-------------------------- +## Common Law Marriage +### Description *proposed description missing* *In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "The fact of a marriage by common law." ### Value - Found in the following historical records: - (records not yet identified) ### Absence - The most closely related structures are: - `MARR`: can express a marriage of any type, potentially including common law marriages. Common law marriages can differ from other marriages, however, in that they may lack a ceremony or event marking the entrance into the married state. +``` +1 MARR +2 TYPE Common Law +``` + Related proposals include - Lived Together (in the Family Attributes document): some interpretations of common law marriage and cohabitation are very similar to one another ### Used - - Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/CommonLawMarriage` - - Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) via GEDCOM X. +-------------------------- ## Divorce +### Description +Dissolving a marriage through civil action. + +### Value + + +### Absence + + +### Used +*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md)* with URI `http://gedcomx.org/Divorce` + +-------------------------- +## Divore Filed +### Description +Filing for a divorce by a spouse. + +### Value + + +### Absence + + +### Used + + +-------------------------- +## Engagement +### Description +Recording or announcing an agreement between 2 people to become married. + +### Value + -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Divorce` +### Absence + + +### Used + +-------------------------- ## Marriage +### Description +A legal, common-law, or customary event such as a wedding or marriage ceremony that joins 2 partners to create or extend a family unit. + +### Value + + +### Absence + + +### Used +- *In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md)* with URI `http://gedcomx.org/Marriage` + +-------------------------- +## Marriage Bann +### Description +Official public notice given that 2 people intend to marry. + +### Value + + +### Absence + + +### Used + + +-------------------------- +## Marriage License +### Description +Obtaining a legal license to marry. + +### Value + + +### Absence + + +### Used + + +-------------------------- +## Marriage Settlement +### Description +Creating an agreement between 2 people contemplating marriage, at which time they agree to release or modify property rights that would otherwise arise from the marriage. + +### Value + + +### Absence + + +### Used + -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Marriage` +-------------------------- diff --git a/attribute-event-requests/INDI-attribute.md b/attribute-event-requests/INDI-attribute.md index 3faecd37..202167cf 100644 --- a/attribute-event-requests/INDI-attribute.md +++ b/attribute-event-requests/INDI-attribute.md @@ -7,54 +7,45 @@ Guides for using this document can be found in the associated [README.md](README | G7 Tag | Since | Name | Notes | |:------:|-------|------|-------| -| | | [Affiliation](#affiliation) | | -| `CAST` | 5.0 | [Caste](#caste) | | -| \* | 5.0 | [Childless](#childless) | encoded as `NCH 0` | -| | | [Clan](#clan) | | -| \* | 3.0 | [Died Before Eight](#died-before-eight) | encoded as `DEAT`.`AGE <8y` | -| `EDUC` | 4.0 | Education | | -| | | [Ethnicity](#ethnicity) | | -| | | [Heimat](#heimat) | | -| `IDNO` | 5.3 | [Identifying Number](#identifying-number) | | -| | | [Life Sketch](#life-sketch) | | -| | | [Military Service](#military-service) | | -| `IDNO` | 5.3 | [National ID](#national-id) | see also `SSN` | -| `NATI` | 5.0 | [Nationality](#nationality) | | -| `NCHI` | 5.0 | Number of Children | | -| `NMR` | 5.0 | Number of Marriages | really number of `FAM`s; marriage not required | -| `OCCU` | 3.0 | [Occupation](#occupation) | | -| `DSCR` | 5.0 | [Physical Description](#physical-description) | | -| `PROP` | 3.0 | Property | | -| `RELI` | 3.0 | [Religion](#religion) | | -| `RESI` | 3.0 | [Residence](#residence) | | -| \* | 5.0 | [Single](#single) | encoded as `NMR 0` | -| `SSN` | 5.3 | Social Security Number | the USA's `IDNO` equivalent | -| `TITL` | 3.0 | [Title](#title) | | -| | | [Tribe](#tribe) | | - +| | Proposed | [Affiliation](#affiliation) | see [Nationality](#nationality) | +| `CAST` | 5.0 | [Caste](#caste) | | +| \* | 5.0 | [Childless](#childless) | encoded as `NCH 0` | +| \* | Proposed | [Clan](#clan) | see [Nationality](#nationality) definition | +| \* | 3.0 | [Died Before Eight](#died-before-eight) | encoded as `DEAT.AGE` <8y | +| `DNA` | Proposed | [DNA](#dna) | enumerated `DNA.TYPE` | +| `EDUC` | 4.0 | [Education](#education) | | +| \* | Proposed | [Ethnicity](#ethnicity) | see [Nationality](#nationality) definition | +| | Proposed | [Heimat](#heimat) | | +| `IDNO` | 5.3 | [Identifying Number](#identifying-number) | see `SSN` | +| | Proposed | [Life Sketch](#life-sketch) | | +| `MILT` | Proposed | [Military Service](#military-service) | This be an "Event" Enumerate `MILT.TYPE` to add additional military related items. | +| `IDNO` | 5.0 | [National ID](#national-id) | see also `SSN` | +| `NATI` | 5.0 | [Nationality](#nationality) | | +| `TITL` | 3.0 | [Nobility Title](#nobility-title) | | +| `NCHI` | 5.0 | [Number of Children](#number-of-children) | | +| `NMR` | 5.0 | [Number of Marriages](#number-of-marriages) | really number of `FAMS` links; marriage not required | +| `OCCU` | 3.0 | [Occupation](#occupation) | | +| `DSCR` | 5.0 | [Physical Description](#physical-description) | | +| `PROP` | 3.0 | [Property](#property) | | +| `RELI` | 3.0 | [Religion](#religion) | | +| `RESI` | 3.0 | [Residence](#residence) | | +| \* | Proposed | [Single](#single) | | +| `SSN` | 5.3 | [Social Security Number](#social-security-number) | the USA's `IDNO` equivalent | +| \* | Proposed | [Tribe](#tribe) | see [Nationality](#nationality) definition | # Details - - +-------------------------- ## Affiliation - ### Description - *proposed description missing* -*In [FamilySearch API documentation](https://www.familysearch.org/developers/docs/guides/facts)* without a definition - ### Value - Found in the following historical records: - (records not yet identified) ### Absence - The most closely related structures are: -- - Related proposals include - Clan: *difference from Affiliation not yet articulated* @@ -63,185 +54,221 @@ Related proposals include - Heimat: *difference from Affiliation not yet articulated* ### Used - - Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/Affiliation` +- *In [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts)* documentation without a definition +-------------------------- +## Caste +### Description +The name of an individual's rank or status in society which is sometimes based on racial or religious differences, or differences in wealth, inherited rank, profession, or occupation. +### Value -## Caste -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Caste` +### Absence + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Caste +- Used by the FamilySearch API via GEDCOM X +-------------------------- ## Childless +### Description +The assertion that a family does not have children can be made using the `NCHI` structure with payload "0". +This is distinct from simply not having any `CHIL` structures, which might mean there are children that have not yet been added to the data. -The assertion that a family does not have children can be made using the `NCHI` structure with payload "`0`". -This is distinct from simply not having any `CHIL` structures, -which might mean there are children that have not yet been added to the data. +### Value -### Used -- Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as a distinct stucture with URI `http://familysearch.org/v1/CoupleNeverHadChildren` +### Absence + +### Used +- Part of the GEDCOM X specification as a distinct stucture with URI http://familysearch.org/v1/CoupleNeverHadChildren +-------------------------- ## Clan - ### Description - *proposed description missing* -*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's clan." - ### Value - Found in the following historical records: - (records not yet identified) ### Absence - The most closely related structures are: -- - Related proposals include - Tribe: *difference from Clan not yet articulated* - Ethnicity: *difference from Clan not yet articulated* -- Heimat: a place, often as a disambiguation of family name or lineage. Clan suggests group identity, not geography -- Affiliation: generally by choice or appointment, while clan generally indicates something assigned to a person at birth +- Heimat: *a place, often as a disambiguation of family name or lineage. Clan suggests group identity, not geography* +- Affiliation: *generally by choice or appointment, while clan generally indicates something assigned to a person at birth* ### Used -- Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Clan` - -- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) via GEDCOM X. +- [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Clan` +- [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) via GEDCOM X. +- *In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's clan." +-------------------------- ## Died Before Eight +### Description +The assertion that a person died before the end of their eighth year of life can be made using the `DEAT` structure with an AGE substructure with payload "< 8y". -The assertion that a person died before the end of their eighth year of life can be made using the `DEAT` structure with an `AGE` substructure with payload "`< 8y`". +### Value -### Used -- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/DiedBeforeEight` +### Absence -## Ethnicity +### Used +- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI http://familysearch.org/v1/DiedBeforeEight +-------------------------- +## DNA ### Description -*proposed description missing* -*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's ethnicity." +### Value + + +### Absence + + +### Used +Proposed Use And Examples + +-DNA.TYPE: can provide a user-language-specific indication of the various types of DNA + +``` +1 DNA Haplogroup H +2 TYPE mtDNA +``` + +``` +1 DNA Haplogroup R1 +2 TYPE Y-DNA +``` + +-------------------------- +## Education +### Description +A fact of an education or an educational achievement (e.g., diploma, graduation, scholarship, etc.) of a person. ### Value + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Education +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Ethnicity +### Description + + +### Value Found in the following historical records: - (records not yet identified) ### Absence - The most closely related structures are: -- - Related proposals include - Tribe: *difference from Ethnicity not yet articulated* - Clan: *difference from Ethnicity not yet articulated* -- Heimat: a place, often as a disambiguation of family name or lineage. Ethnicity suggests group identity, not geography -- Affiliation: generally an organized group by choice or appointment, while ethnicity generally indicates a broader culture my self-identification +- Heimat: *a place, often as a disambiguation of family name or lineage. Ethnicity suggests group identity, not geography* +- Affiliation: *generally an organized group by choice or appointment, while ethnicity generally indicates a broader culture my self-identification* ### Used - -- Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Ethnicity` - +- [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Ethnicity` - Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) via GEDCOM X. +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as "A fact of a person's ethnicity." - +-------------------------- ## Heimat - ### Description - A geographic place to which a person is affiliated by birth or ancestry, but not necessarily by residence or property. -*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's _heimat_. "Heimat" refers to a person's affiliation by birth to a specific geographic place. Distinct heimaten are often useful as indicators that two persons of the same name are not likely to be closely related genealogically. In English, "heimat" may be described using terms like "ancestral home", "homeland", or "place of origin". - +In GEDCOM X as "A fact of a person's _heimat_. "Heimat" refers to a person's affiliation by birth to a specific geographic place. Distinct heimaten are often useful as indicators that two persons of the same name are not likely to be closely related genealogically. In English, "heimat" may be described using terms like "ancestral home", "homeland", or "place of origin". ### Value - Found in the following historical records: - (records not yet identified) ### Absence - The most closely related structures are: -- - Related proposals include - Ethnicity: ethnicities typically have some geographic association, but generally much larger and less fine-grained than a heimat - Tribe: members of a tribe may share a heimat, but tribes may be defined by other characteristics too - Clan: members of a clan may share a heimat, but clans may be defined by other characteristics too +- Bürgerort: a place, often as a disambiguation of family name or lineage. - Affiliation: a person with a given heimat needn't have any affiliation with others with the same heimat ### Used - - Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Heimat` - - *Not* used by the FamilySearch API, the GEDCOM-X implementation with the largest user base; see - +- *Not* used by the FamilySearch API, the GEDCOM-X implementation with the largest user base; see +-------------------------- ## Identifying Number +### Description +A number or other string assigned to identify a person within some significant external system. It must have a TYPE substructure to define what kind of identification number is being provided. [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) has a subset of these (only those issued by nations) under [National Id](#national-id). +### Value -## Life Sketch -### Description +### Absence -*proposed description missing* -*In [FamilySearch API documentation](https://www.familysearch.org/developers/docs/guides/facts)* without a definition +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Adoption +- Used by the FamilySearch API via GEDCOM X +- GEDCOM X has a subset of these (only those issued by nations) under National Id. -### Value +-------------------------- +## Life Sketch +### Description +*proposed description missing* -Found in the following historical records: +### Value -- ### Absence - The most closely related structures are: - `NOTE`: a life sketch is not a historical attribute in the usual sense (it lacks a date, place, associated individuals, etc). There is a proposal ([issue #219](https://github.com/FamilySearch/GEDCOM/issues/219)) to add note type to cover this instead of a new attribute. -There are no similar proposals here. +There are no similar proposals here ### Used - - Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/LifeSketch` - Used by Ancestry, under the name "Life Story" - Used by FindAGrave, under the name "Bio Information" +- *In [FamilySearch API documentation](https://www.familysearch.org/developers/docs/guides/facts)* without a definition - - - +-------------------------- ## Military Service - ### Description -*proposed description missing* - -*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's military service." ### Value - Found in the following historical records: - Military induction papers @@ -252,88 +279,247 @@ Found in the following historical records: - Private journals, biographies, and obituaries ### Absence - The most closely related structures are: -- - -Related proposals include +Related proposals include: - GEDCOM-X has events "Military Induction" and "Military Discharge" which define the start and end of the military service ### Used - - Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/MilitaryService` - - Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) via GEDCOM X. +- *In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's military service." +Several application have created a custom event called _MILT to support some aspect of Military Service +- `MILT`.`TYPE`: enumeration can provide a user-language-specific indication of the various concepts found in serving in the military. GEDCOM-X suggests multiple additions that are “military based” events. A single event MILT with Typification of, a) induction, b) rank, c) discharge, d) engagement, e) registration, f) deployment, g) other/phrase (NOTE: GEDCOM X has a dozen or more of these, some are subset of others (there are over 300 separation codes as part of a “discharge”. AWOL, Desertion being one) +For Example: +``` +1 MILT +2 TYPE Induction +``` -## National ID +``` +1 MILT Sergeant +2 TYPE Rank +``` + +``` +1 MILT Battle of +2 TYPE Engagement +``` +-------------------------- +## National ID +### Description In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/NationalId`. A special case of [Identifying number](#identifying-number) +### Value + + +### Absence + + +### Used + + +-------------------------- ## Nationality +### Description +An individual’s national heritage or origin, or other folk, house, kindred, lineage, or tribal interest. + +### Value + + +### Absence + + +### Used +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Nationality` + +-------------------------- +## Nobility Title +### Description +The title given to or used by a person, especially of royalty or other noble class within a locality, such as "Grand Duke". + +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Used by the FamilySearch API http://familysearch.org/v1/TitleOfNobility +- In [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/TitleOfNobility` + +-------------------------- +## Number of Children +### Description +The number of children that this person is known to be the parent of (all marriages). + +### Value -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Nationality` +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/NumberOfChildren +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Number of Marriages +### Description +The number of times this person has participated in a family as a spouse or parent. + +### Value + + +### Absence + + +### Used + + +-------------------------- ## Occupation +### Description +The type of work or profession of an individual. -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Occupation` +### Value + + +### Absence + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Occupation +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Occupation` + +-------------------------- ## Physical Description +### Description + -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/PhysicalDescription` +### Value + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/PhysicalDescription +- Used by the FamilySearch API via GEDCOM X + +DESC.TYPE: can provide a user-language-specific indication of multiple aspects of an individual's physical description. Enumerated example: {height, weight, eye color, tattoos, skin color, hair color, scars, lost limbs, other/phrase}. +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/PhysicalDescription` + +For example: +``` +1 DESC Brown +2 TYPE Hair Color +``` + +-------------------------- +## Property +### Description +Pertaining to possessions such as real estate or other property of interest. + +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Property +- Used by the FamilySearch API via GEDCOM X + +-------------------------- ## Religion +### Description +A religious denomination to which a person is affiliated or for which a record applies. + +### Value -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Religion` +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Religion +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Religion` + +-------------------------- ## Residence +### Description +An address or place of residence where an individual resided. -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Residence` +### Value -## Single -The assertion that a person is not a partner in a family can be made using the `NMR` structure with payload "`0`". -This is distinct from simply not having any `FAMS` structures, -which might mean there are relationships that have not yet been added to the data. +### Absence + ### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Residence +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Residence` -- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/NoCoupleRelationships` +-------------------------- +## Single +### Description +The assertion that a person is not a partner in a family can be made using the `NMR` structure with payload "0". +This is distinct from simply not having any FAMS structures, which might mean there are relationships that have not yet been added to the data. -## Title +### Value -In [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/TitleOfNobility` +### Absence -## Tribe +### Used +- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI http://familysearch.org/v1/NoCoupleRelationships +-------------------------- +## Social Security Number ### Description +A number assigned by the United States Social Security Administration, used for tax identification purposes. It is a type of `IDNO`. -*proposed description missing* +### Value -*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's tribe." -*In [FamilySearch API documentation](https://www.familysearch.org/developers/docs/guides/facts)* without a definition, and with a different URI than that used by GEDCOM-X +### Absence -### Value +### Used +- Part of the GEDCOM v7.0 Specification + +-------------------------- +## Tribe +### Description + + +### Value Found in the following historical records: - (records not yet identified) ### Absence - The most closely related structures are: -- - -Related proposals include +Related proposals include: - Clan: *difference from Tribe not yet articulated* - Ethnicity: *difference from Tribe not yet articulated* @@ -341,7 +527,9 @@ Related proposals include - Affiliation: generally by choice or appointment, while tribe generally indicates something assigned to a person at birth ### Used - - Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Tribe` - - Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) with URI `http://familysearch.org/v1/TribeName` +- *In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's tribe." +- *In [FamilySearch API documentation](https://www.familysearch.org/developers/docs/guides/facts)* without a definition, and with a different URI than that used by GEDCOM-X + +-------------------------- diff --git a/attribute-event-requests/INDI-event.md b/attribute-event-requests/INDI-event.md index bab9a3dc..c409359b 100644 --- a/attribute-event-requests/INDI-event.md +++ b/attribute-event-requests/INDI-event.md @@ -7,100 +7,431 @@ Guides for using this document can be found in the associated [README.md](README | G7 Tag | Since | Name | Notes | |:------:|-------|------|-------| -| `ADOP` | 3.0 | Adoption | | -| `CHRA` | 5.0 | Adult Christening | | -| `BAPM` | 3.0 | Baptism | | -| `BARM` | 4.0 | [Bar Mitzvah](#bar-mitzvah) | | -| `BASM` | 4.0 | [Bat Mitzvah](#bat-mitzvah) | | -| `BIRT` | 3.0 | [Birth](#birth) | | -| `BLES` | 3.0 | Blessing | | -| `BURI` | 3.0 | [Burial](#burial) | | -| `CENS` | 3.0 | Census | | -| `CHR` | 3.0 | [Christening](#christening) | | -| `CONF` | 3.0 | Confirmation | | -| `CREM` | 5.4 | [Cremation](#cremation) | | -| `DEAT` | 3.0 | [Death](#death) | | -| `EMIG` | 3.0 | Emigration | | -| `FCOM` | 4.0 | First Communion | | -| `GRAD` | 4.0 | Graduation | | -| `IMMI` | 3.0 | [Immigration](#immigration) | | -| `NATU` | 3.0 | [Naturalization](#naturalization) | | -| `ORDN` | 3.0 | Ordination | | -| `PROB` | 3.0 | Probate | | -| `RETI` | 4.0 | Retirement | | -| | | [Stillbirth](#stillbirth) | perhaps `BIRT`.`TYPE Stillborn` or `DEAT`.`AGE 0y`? | -| `WILL` | 3.0 | Will | | +| `ADOP` | 3.0 | [Adoption](#adoption) | | +| `CHRA` | 3.0 | [Adult Christening](#adult-christening) | | +| `BAPM` | 3.0 | [Baptism](#baptism) | | +| `BARM` | 4.0 | [Bar Mitzvah](#bar-mitzvah) | | +| `BASM` | 4.0 | [Bat Mitzvah](#bat-mitzvah) | | +| `BIRT` | 3.0 | [Birth](#birth) | Enumerated `BIRT.TYPE` values. | +| `BLES` | 3.0 | [Blessing](#blessing) | | +| `BURI` | 3.0 | [Burial](#burial) | | +| `CHR` | 3.0 | [Christening](#christening) | | +| `CONF` | 3.0 | [Confirmation](#confirmation) | | +| `CREM` | 5.4 | [Cremation](#cremation) | see "Burial" | +| `DEAT` | 3.0 | [Death](#death) | | +| `EMIG` | 3.0 | [Emigration](#emigration) | | +| `FCOM` | 4.0 | [First Communiion](#first-communiion) | | +| `GRAD` | 4.0 | [Graduation](#graduation) | | +| `IMMI` | 3.0 | [Immigration](#immigration) | | +| `MEDI` | Proposed | [Medical Health](#medical-health) | This tag can be either an attribute or an event. Some of these "types" could be an event or an attribute. | +| `NATU` | 3.0 | [Naturalization](#naturalization) | | +| `ORDN` | 3.0 | [Ordination](#ordination) | | +| `PROB` | 3.0 | [Probate](#probate) | | +| `RETI` | 4.0 | [Retirement](#retirement) | | +| \* | Proposed | [Stillbirth](#stillbirth) | see [Birth](#birth) `BIRT.TYPE` | +| `WILL` | 3.0 | [Will](#will) | | +# Details +-------------------------- +## Adoption +### Description +Creation of a legally approved child-parent relationship that does not exist biologically. +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Adoption +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Adult Christening +### Description +Baptism or naming events for an adult person. + +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/AdultChristening +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Baptism +### Description +Baptism, performed in infancy or later. (See also [`BAPL`](#latter-day-saint-ordinances) and `CHR`.) + +### Value + + +### Absence -# Details +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI `http://gedcomx.org/Baptism` +- Used by the FamilySearch API via GEDCOM X + +-------------------------- ## Bar Mitzvah +### Description +The ceremonial event held when a Jewish boy reaches age 13. -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/BarMitzvah` +### Value + + +### Absence + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with http://gedcomx.org/BarMitzvah +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/BarMitzvah` + +-------------------------- ## Bat Mitzvah +### Description +The ceremonial event held when a Jewish girl reaches age 13, also known as "Bat Mitzvah." + +### Value -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/BatMitzvah` +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/BatMitzvah +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/BatMitzvah` + +-------------------------- ## Birth +### Description +- Birth/Born can be defined as coming into existence. This could mean either "Live Birth" or "Still Born". + +-BIRT.TYPE enumeration options {Vaginal Birth, Cesarean Birth, Still Birth} + +### Value + + +### Absence + -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Birth` +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with http://gedcomx.org/Birth +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Birth` + +-------------------------- +## Blessing +### Description +Bestowing divine care or intercession. Sometimes given in connection with a naming ceremony. + +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Blessing +- Used by the FamilySearch API via GEDCOM X +-------------------------- ## Burial +### Description +Disposing of the mortal remains of a deceased person. + +- Burial can be defined as the disposition of a decedent which can include: Inhumation, Burial at Sea, Cremation, Donation to Research, Lost, Natural, Green, Burial Tree or Scaffolding, cave and probably many other ones depending on culture. +-The BURI event can can therefore have BURI.TYPE enumerations of: a) Inhumation, b) Burial at Sea, c) Cremation, d) Donation to Research, e) Lost, f) Natural, g) Green, h) Burial Tree or Scaffolding, i) cave, j) other/phrase -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Burial` +### Value + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with `http://gedcomx.org/Burial` +- Used by the FamilySearch API via GEDCOM X +*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md)* with URI `http://gedcomx.org/Burial` + +-------------------------- ## Christening +### Description +Baptism or naming events for a child. + +### Value + + +### Absence -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Christening` +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with http://gedcomx.org/Christening +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Christening` + +-------------------------- +## Confirmation +### Description + + +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Confirmation +- Used by the FamilySearch API via GEDCOM X + +-------------------------- ## Cremation +### Description -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Cremation` +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Cremation +- Used by the FamilySearch API via GEDCOM X +- Closely related to the Burial event if the `BURI.TYPE` enumeration was implemented. +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Cremation` + +-------------------------- ## Death +### Description + + +### Value + -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Death` +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Death +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Death` + +-------------------------- +## Emigration +### Description + + +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Emigration +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## First Communiion +### Description + A fact of a person's first communion in a church. + +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with http://gedcomx.org/FirstCommunion +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Graduation +### Description +A fact of a person's graduation from a scholastic institution, may include, public, private, trade, or other schools of study. +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI `http://gedcomx.org/Graduation` +- Used by the FamilySearch API via GEDCOM X + +-------------------------- ## Immigration +### Description + + +### Value + -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Immigration` +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Immigration +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Immigration` +-------------------------- +## Medical Health +### Description +Any medical or health related events/attributes that people like to record. Since this can be a very open ended list, an Other/Phrase component as part of typification must be included as well as allowing for an `Event` to have a text value! + +### Value +Found in the following historical records: + +- Public Records +- Military Records +- Private journals, biographies, bibles, and obituaries + +### Absence +- Found in many GEDCOM files in the wild. + +### Used +- `MEDI.TYPE`: can provide a user-language-specific indication of the various concepts found in private and governmental documents. A single event (this could be an attribute too!) HEAL with Typification of, a) disease, b) hospitalization, c) other/phrase (NOTE: It has been seen in the wild multiple cases where medical/health related events and attributes have been documented) + +For Example: +``` +1 MEDI amputation of right leg +2 TYPE surgery +``` +``` +1 MEDI contracted consumption as a child +2 TYPE disease +``` + +-------------------------- ## Naturalization +### Description -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Naturalization` -## Religion +### Value -In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Religion` +### Absence -## Stillbirth +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Naturalization +- Used by the FamilySearch API via GEDCOM X +- In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Naturalization` + +-------------------------- +## Ordination ### Description -Born dead or died shortly after birth (exact definitions vary by culture and time period). -*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's stillbirth." +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Ordination +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Probate +### Description + ### Value -Found in the following historical records: -- (records not yet identified) +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Probate +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Retirement +### Description + + +### Value + ### Absence + +### Used +- Part of the GEDCOM v7.0 Specification +- Part of the GEDCOM X specification with URI http://gedcomx.org/Retirement +- Used by the FamilySearch API via GEDCOM X + +-------------------------- +## Stillbirth +### Description +Born dead or died shortly after birth (exact definitions vary by culture and time period). + +In GEDCOM X as "A fact of a person's stillbirth." + +### Value +Found in the following historical records: +*In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's stillbirth." + +### Absence The most closely related structures are: -- `DEAT`.`AGE`: can express any specific meaning (`< 0y`, `< 0d`, etc), and had a special value for "stillborn" in 5.5.1 and before: that special value was removed from `AGE` payloads in 7.0 because it was not a valid age in any other context. -- `BIRT`.`TYPE`: can provide a user-language-specific indication of stillbirth; this is used as an example of `TYPE` in the 7.0 specification. +- `DEAT.AGE`: can express any specific meaning (< 0y, < 0d, etc), and had a special value for "stillborn" in 5.5.1 and before: that special value was removed from `AGE` payloads in 7.0 because it was not a valid age in any other context. +- `BIRT.TYPE`: can provide a user-language-specific indication of stillbirth; this is used as an example of `TYPE` in the 7.0 specification. There are no similar proposals here. ### Used +- Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/StillBirth` +- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) via GEDCOM X +- *In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) as* "A fact of a person's stillbirth." -- Part of the [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/BarMitzvah` +-------------------------- +## Will +### Description -- Used by the [FamilySearch API](https://www.familysearch.org/developers/docs/guides/facts) via GEDCOM X +### Value + + +### Absence + + +### Used +- Part of the GEDCOM v7.0 Specification +- [GEDCOM X specification](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Will' +- Used by the FamilySearch API via GEDCOM X + +--------------------------