diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6ac388e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# cryptocores
+cryptography ip-cores in vhdl / verilog
+
+The components in this repository are not intended for productional code.
+They serve as proof of concept, for example how to implement a pipeline using
+only (local) variables instead of (global) signals. Furthermore they were used
+how to do a VHDL-to-Verilog conversion for learning purposes.