diff --git a/README.md b/README.md
new file mode 100644
index 0000000..46c72d7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Codigo para llevar's generator
+
+This is the static site generator used to build [Codigo Para Llevar](https://codigoparallevar.com/) (my personal site). It contains:
+
+- A markdown blog (with content ported from acrylamid). Saved as `/blog/`.
+- A set of org-mode based notes. Saved as `/notes/`.
+
+It also copies over some static assets (css, js, fonts).
+
+The scripts are hardcoded with the hostnames and paths for my own site, so you might want to update them.
+
+General documentation is in progress and might be replaced little by little by the more interactive [org-web-editor](https://code.codigoparallevar.com/kenkeiras/org-web-editor) once that one (1) supports all the features here and (2) has support for building static sites.