From 821c38f873133f7721326ff50bd273033c2e9bd3 Mon Sep 17 00:00:00 2001
From: Clair Blacketer <clair.blacketer@gmail.com>
Date: Thu, 18 Apr 2024 12:48:06 -0400
Subject: [PATCH] death date definition

closes #104
---
 docs/pages/death/death.md           |  5 +---
 docs/pages/death/death_month_day.md | 45 +++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+), 4 deletions(-)
 create mode 100644 docs/pages/death/death_month_day.md

diff --git a/docs/pages/death/death.md b/docs/pages/death/death.md
index 3f71001..01d90b5 100644
--- a/docs/pages/death/death.md
+++ b/docs/pages/death/death.md
@@ -8,9 +8,6 @@ sidebar: mydoc_sidebar
 permalink: /death.html
 ---
 
-## Table-level Conventions
-
-- Convention1
 
 ## Field-level Conventions
 
@@ -18,5 +15,5 @@ permalink: /death.html
 |:--------|:-------|
 | DEATH_DATE   |  [How to populate death_date when it is missing from the source](missing_death_date.html)  |
 |----
-|  |    |
+| DEATH_DATE |  [How to populate the death date when you only have the year or year and month](death_month_day.html)  |
 |=====
\ No newline at end of file
diff --git a/docs/pages/death/death_month_day.md b/docs/pages/death/death_month_day.md
new file mode 100644
index 0000000..af0ee8b
--- /dev/null
+++ b/docs/pages/death/death_month_day.md
@@ -0,0 +1,45 @@
+---
+title: How to populate the death date when you only have the year or year and month
+keywords: death, death date
+last_updated: April 18, 2024
+tags: [death, death_date, dates]
+sidebar: mydoc_sidebar
+permalink: /death_month_day.html
+---
+
+## Issue # and location
+[Themis issue #104](https://github.com/OHDSI/Themis/issues/104)
+
+## Issue summary
+The `death.death_date` field has day resolution. Some source data may not have complete datestamp of the deceased persons' death date. How should the day be approximated if only the year or year and month of death are available?
+
+## Convention type
+Table
+
+## CDM table
+`DEATH`
+
+## CDM field
+`death_date`
+
+## Links to issue discussion
+[CDM Documentation](https://ohdsi.github.io/CommonDataModel/cdm54.html#death)   
+
+## Provenance of data
+General
+
+## The ratified convention
+- If the given death date only includes month and year, the last day of the month is used as the default. 
+- If the given death date only includes year, December is used as the default month, and the last day of the month the default day.
+
+## Date of ratification/published
+NA
+
+## Downstream implications
+NA
+
+## Link to DQD check
+Yes - [plausibleDuringLife](https://ohdsi.github.io/DataQualityDashboard/articles/checks/plausibleDuringLife.html) and [plausibleBeforeDeath](https://ohdsi.github.io/DataQualityDashboard/articles/checks/plausibleBeforeDeath.html) 
+
+## Related conventions/further information
+NA
\ No newline at end of file