From 7742867b21697cc7eb4ba14454f44daf046515eb Mon Sep 17 00:00:00 2001
From: Adam Shannon <adamkshannon@gmail.com>
Date: Fri, 13 Dec 2024 15:39:37 -0600
Subject: [PATCH] docs: add page on INITIAL_DATA_DIRECTORY

---
 docs/_data/docs-menu.yml |  2 ++
 docs/cache-data-files.md | 42 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 docs/cache-data-files.md

diff --git a/docs/_data/docs-menu.yml b/docs/_data/docs-menu.yml
index 2274902a..b78d5788 100644
--- a/docs/_data/docs-menu.yml
+++ b/docs/_data/docs-menu.yml
@@ -40,3 +40,5 @@
       link: /runbook/
     - name: Prometheus metrics
       link: /metrics/
+    - name: Caching Data Files
+      link: /cache-data-files/
diff --git a/docs/cache-data-files.md b/docs/cache-data-files.md
new file mode 100644
index 00000000..fc8bf238
--- /dev/null
+++ b/docs/cache-data-files.md
@@ -0,0 +1,42 @@
+---
+layout: page
+title: Caching Data Files
+hide_hero: true
+show_sidebar: false
+menubar: docs-menu
+---
+
+# Caching Data Files
+
+Watchman supports sourcing data files from the local filesystem and falling back to the remote servers when local files do not exist. This is helpful for flakey servers or when operating a large number of Watchman instances.
+
+By setting `INITIAL_DATA_DIRECTORY` to a local directory Watchman will look for the following files.
+
+**OFAC**
+
+- `add.csv` - Address
+- `alt.csv` - Alternate ID
+- `sdn.csv` - Specially Designated National
+- `sdn_comments.csv` - Specially Designated National Comments
+
+Download the files from [Data Center - SDN List](https://sanctionslist.ofac.treas.gov/Home/SdnList)
+
+**US Consolidated Screening List**
+
+- `csl.csv` - US Consolidated Screening List
+- `dpl.txt` - US Denied Persons List
+
+Download the [US Consolidated Screening List](https://www.trade.gov/consolidated-screening-list)
+
+**EU Consolidated Screening List**
+
+- `eu_csl.csv` - EU Consolidated Screening List
+
+Download the [EU Consolidated Screening List](https://data.europa.eu/data/datasets/consolidated-list-of-persons-groups-and-entities-subject-to-eu-financial-sanctions?locale=en)
+
+**UK Consolidated Screening List**
+
+- `ConList.csv` - UK Consolidated Screening List
+- `UK_Sanctions_List.ods` - UK Sanctions List
+
+Download the [UK Consolidated Screening List](https://www.gov.uk/government/publications/financial-sanctions-consolidated-list-of-targets/consolidated-list-of-targets#contents) and the [UK Sanctions List](https://www.gov.uk/government/publications/the-uk-sanctions-list)