diff --git a/README b/README
deleted file mode 100644
index 43d23d4..0000000
--- a/README
+++ /dev/null
@@ -1,8 +0,0 @@
-
-Some Debian bugs filed for issues encountered in Kali:
-
-#684865: live-build: lb_binary_syslinux fails to include flavour in menu entry
-#684891: live-build: add a config parameter to define the project name
-#684893: live-build: fails to find bootloaders files when running from git checkout
-#684896: live-build: loading of build.sh does not work as expected in various scripts
-
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f14ab72
--- /dev/null
+++ b/README.md
@@ -0,0 +1,4 @@
+# live-build configuration for Kali ISO images
+
+Have a look at https://docs.kali.org/development/live-build-a-custom-kali-iso
+for explanations on how to use this repository.