Merge pull request #301 from FamilySearch/event-proposals

Structure for proposing new events

attribute-event-requests/FAM-attribute.md

@@ -0,0 +1,55 @@
+# Family Attributes
+
+This document tracks the set of Family Attributes, both those in FamilySearch GEDCOM 7 and those considered for future addition.
+Guides for using this document can be found in the associated [README.md](README.md).
+
+# Table
+
+| 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 | |
+
+# Details
+
+## Childless
+
+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
+
+- 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
+
+### 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`.
+- `MARR`: some interpretations of living together as a couple and some definitions of marriage make living together a type of marriage; other definitions do not.
+
+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`

attribute-event-requests/FAM-event.md

@@ -0,0 +1,63 @@
+# Family Events
+
+This document tracks the set of Family Events, both those in FamilySearch GEDCOM 7 and those considered for future addition.
+Guides for using this document can be found in the associated [README.md](README.md).
+
+# Table
+
+| 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 | |
+
+# Details
+
+## Annulment
+
+In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Annulment`
+
+## 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.
+
+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
+
+In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Divorce`
+
+## Marriage
+
+In [GEDCOM X](https://github.com/FamilySearch/gedcomx/blob/master/specifications/fact-types-specification.md) with URI `http://gedcomx.org/Marriage`