diff --git a/README.md b/README.md
index 81878a5..f7b2985 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,12 @@
-# python-optimization
\ No newline at end of file
+# python-optimization
+
+This repo is meant to be a collection of optimazations you can try, if you find yourself in a slow loop.
+
+Optimization tecniques will be added, with example code, from time to time.
+Overall there are a few omtimizations worth mentioning.
+
+* @cache - __functools__
+
+## Text comparison optimizations
+If you know the textlength of a piece of text, you want to see if another piece of text startswith/endswith.
+Then slicing is generally faster.