diff --git a/README.md b/README.md
index d5c85df..7d4858f 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,5 @@
-// TODO link to docs
\ No newline at end of file
+# QMK Userspace
+
+This is the QMK Userspace for the Bastard Keyboards keymaps.
+
+You can read how to compile your own keymap on the official docs here: [https://docs.bastardkb.com/fw/compile-firmware.html](https://docs.bastardkb.com/fw/compile-firmware.html).
\ No newline at end of file