diff --git a/TODO.md b/TODO.md
index 32a1791..4634478 100644
--- a/TODO.md
+++ b/TODO.md
@@ -1,6 +1,22 @@
 TODO:
-- if curl is not installed, use wget
-- write an ADR
-- record the UX design
-  - how do we publish?
+- [ ] if curl is not installed, use wget
+- [ ] write an ADR
+- [x] record the UX design
+- [ ] how do we publish?
 
+instructions given to user:
+"""
+To approve all failing tests, either:
+- run the following
+```
+run ./.approvaltests_temp/ensure_uv_installed
+uv run approvaltests_temp/approve_all.py
+```
+or
+- run `python3 approvaltests_temp/approve_all.py`
+"""
+
+alternate UX:
+`uv tool run approvaltests --approve--all`
+or
+`python -m approvaltests --approve-all`