diff --git a/README.md b/README.md
index 1fc768f..963ad21 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
 # aproxy
 
-Activity Pub Reverse Proxy Framework
\ No newline at end of file
+Activity Pub Reverse Proxy Framework
+
+this is a collection of OpenResty scripts that provide different functionality
+on top of ActivityPub implementations.
+
+## TODO
+
+- write example script
+- write test suite
+- create install instructions
+