diff --git a/docs/optimization.txt b/docs/optimization.txt
new file mode 100644
index 00000000..43569be0
--- /dev/null
+++ b/docs/optimization.txt
@@ -0,0 +1,11 @@
+
+Optimization
+
+Here are some possible optimization techniques we can apply to code sections if
+they turn out to be slow.  Be sure not to prematurely optimize though!
+
+ - Make Tokens Flyweights
+ - Rewrite regexps into PHP code
+ - Serialize the Definition object
+ - Batch regexp validation (do as many per function call as possible)
+ - Parallelize strategies