diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3127443
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# Crossword generator
+
+### Usage
+See `src/main/java/eu/m724/crossword/Main.java`
+
+### Speed
+Generally, slow. \
+Compared to mining:
+- difficulty: the "tighter", the slower. It has to fit the words on the surface somehow, it bruteforces a good placement, if it's more crowded it'll have to try harder
+- luck
\ No newline at end of file