diff --git a/README.md b/README.md
index 0263eb1..85a7741 100644
--- a/README.md
+++ b/README.md
@@ -33,4 +33,12 @@ a library for parsing Bitsy game data.
 * game from
 * game to
 
-### 
\ No newline at end of file
+### tidy up
+
+split into multiple files
+move tests to their own suite
+migrate to idiomatic rust etc.
+
+### documentation
+
+examples of use cases (dedupe tiles, merge games, etc.)