diff --git a/.python-version b/.python-version
new file mode 100644
index 0000000..e4fba21
--- /dev/null
+++ b/.python-version
@@ -0,0 +1 @@
+3.12
diff --git a/README.md b/README.md
index 8537efc..f465ad3 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,26 @@
-# html-tictactoe
\ No newline at end of file
+# Tic-Tac-Toe in HTML
+
+## Yes, really.
+
+This is my version of Tic-tac-toe with all the game state encoded in the URL.
+If you want to know more about how this works in theory, check out my 
+[blog post](https://blog.sigma-star.io/2024/11/tic-tac-toe-in-html/) on the topic.
+
+### But... why?
+
+It's fun.
+
+### Why are there Python files?
+
+Since I'm not writing 443 HTML files by hand I wrote a script to generate them.
+
+## How to run?
+
+You'll need Python 3.12 and Poetry.
+
+```bash
+poetry install
+poetry run python -m generator
+```
+
+The generated HTML files are stored in the output/ directory.