diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7ec0dcf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# Plasma Settings
+
+Settings application for Plasma Mobile.
+
+## API
+
+You can find documentation for using the Active Settings infrastructure at
+[docs.plasma-mobile.org/PlasmaSettings.html](https://docs.plasma-mobile.org/PlasmaSettings.html)
diff --git a/README.txt b/README.txt
deleted file mode 100644
index eeb40af..0000000
--- a/README.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-You can find documentation for using the Active Settings infrastructure at
-http://techbase.kde.org/Development/Tutorials/Plasma/QML/ActiveSettings