diff --git a/README.md b/README.md
index 61d91ab..02ccc21 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,8 @@
-# all_strings
+# All Strings
+
+A short bit of code to create every possible string combination of given length, with a given charset. The program outputs the combinations to `stdout` and periodic statistics to `stderr`.
+
+This project uses quite a bit of `unsafe` blocks to acheive the equivilent of java's `public static` in the form of `static mut`. I know some people don't like unsafe rust code, if you are one of those people... too bad.
+
+Since this code is just single-threaded I can only get about 5M permutations a second when not IO limited. (Tested by redirecting `stduout` to `/dev/null`). Later on I might make this multi-threaded to speed up the calculation speed.