diff --git a/README b/README
new file mode 100644
index 0000000..76b6522
--- /dev/null
+++ b/README
@@ -0,0 +1,16 @@
+toki pona Rhyme Tables
+---
+
+toki pona is a language that is spelled entirely phonetically, which means it's
+possible to determine which words rhyme based on text alone.
+
+this repository contains a program to do just that, along with associated inputs
+and outputs for easy viewing.
+
+- `gen_rhymes.py` - the program. invoke with `python gen_rhymes.py <dictionary>`
+- `nimi_pu_en_nimi_ku.txt` - rhymes among all pu and ku words
+- `nimi_pu_en_nimi_ku_lili_taso.txt` - rhymes among all pu and a few ku words
+- `nimi_pu.txt` - rhymes among only pu words
+- `dicts/nimi_pu.dict` - words from pu
+- `dicts/nimi_pu_en_nimi_ku.dict` - words from pu and ku
+- `dicts/nimi_pu_en_nimi_ku_lili_taso.dict` words from pu and some from ku
diff --git a/nimi_pu_en_nimi_ku_lili_taso_rhymes.txt b/nimi_pu_en_nimi_ku_lili_taso.txt
similarity index 100%
rename from nimi_pu_en_nimi_ku_lili_taso_rhymes.txt
rename to nimi_pu_en_nimi_ku_lili_taso.txt