diff --git a/README.md b/README.md
index 7b1f32f..7b736ed 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,5 @@
 # freemodel-workspaces
-Data collected on free models containing workspaces.
+Data collected on free models containing workspaces 
+This repository contains curated lists of Roblox Model asset IDs that include `Workspace instances`, organized by year. The data was collected using using [`workspace-detector`](https://github.com/filoxen/workspace-detector).
+
+Each year is represented as a plain text file under the `assets/` folder. The files contain newline-separated asset IDs for Free Models containing Workspaces.