1 files changed, 18 insertions, 0 deletions
diff --git a/README.md b/README.md
index 54bf5b5..3e150f7 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,19 @@
 # Israeli Election Data
+
+Election data for the last (4, and counting) election cycles in Israel from 2019.
+
+## Data
+
+- Data by ballots in [`ballots/`](ballots)
+- Data by cities in [`cities/`](cities)
+
+## Dev
+
+```bash
+$ pipenv sync
+$ pipenv run jupyter notebook
+```
+
+## Just show me the data
+
+Go to the rendered notebook at [stats.py.ipynb](stats.py.ipynb)