diff --git a/README b/README
deleted file mode 100644
index e5b62ddbc..000000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-See also: http://community.kde.org/Plasma#Plasma_Workspaces_2
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..18a162e89
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# Plasma Framework
+
+## Introduction
+
+## Links
+
+- Wiki: http://community.kde.org/Plasma#Plasma_Workspaces_2
+- Mailing list: <https://mail.kde.org/mailman/listinfo/plasma-devel>
+- IRC channel: #kde-devel on Freenode
+- Git repository: <https://projects.kde.org/projects/playground/libs/plasma-framework/repository>
diff --git a/plasma-framework.yaml b/plasma-framework.yaml
new file mode 100644
index 000000000..78c0a7541
--- /dev/null
+++ b/plasma-framework.yaml
@@ -0,0 +1 @@
+tier: 3