diff --git a/README.md b/README.md
index 701f8b4..95a2398 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,9 @@
 # PyHP
 
-Python Hypertext Preprocessor - a naive implementation of an idea I had a while back....
\ No newline at end of file
+Python Hypertext Preprocessor - a naive implementation of an idea I had a while back.... This allows embedding python code in Hypertext in a similar way to PHP.
+
+An example file outlining the format is provided.
+
+# How to use:
+
+Put `pyhi.sh` and `pyhp.py` somewhere where your web server can execute them, then configure said web server to execute `.pyh` files using `pyhi.sh`.
\ No newline at end of file