diff --git a/INSTALL b/INSTALL
index 319e7a26d2..0355b80c03 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,3 +1,3 @@
 Please read the documentation on our wiki:
 
-http://techbase.kde.org/Projects/KDevelop4/HowToCompile
+https://community.kde.org/KDevelop/HowToCompile_v5
diff --git a/README b/README
index 3583406121..03add09cfd 100644
--- a/README
+++ b/README
@@ -1,15 +1,26 @@
-KDevelop IDE and Platform
----------------------------
-General information about KDevelop: http://www.kdevelop.org/
-Compiling instructions: http://techbase.kde.org/Projects/KDevelop4/HowToCompile
+# KDevelop
 
-KDevelop Platform API Documentation
-------------------------------------
-API documentation is available from http://api.kde.org/extragear-api/kdevelop-apidocs/kdevplatform/html/index.html
+This repository contains the source code for the KDevelop IDE.
 
-To build it by yourself, make sure you have the kdelibs source available
-Run
-kdelibs/doc/api/doxygen.sh --doxdatadir=kdelibs/doc/common ./
-in the KDevelop top source directory to generate the API documentation. kdelibs
-refers to the kdelibs sources that you need to have downloaded.
+The idea that this repository contains
+- Every plugin related related to C/C++ development
+- Every plugin only specific for KDevelop (e.g. the Welcome Page plugin)
 
+## User Documentation
+
+User documentation is available from:
+https://userbase.kde.org/KDevelop4/Manual
+
+## Compile
+
+To compile KDevelop, please refer to the Wiki instructions:
+https://community.kde.org/KDevelop/HowToCompile_v5
+
+## Contribute
+
+If you want to contribute to KDevelop, please read through:
+https://www.kdevelop.org/contribute-kdevelop
+
+## Development Infrastructure
+- [Bug tracker](https://bugs.kde.org/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=ASSIGNED&bug_status=REOPENED&list_id=1408918&product=kdevelop&query_format=advanced)
+- [Phabricator (task tracker, code review and more)](https://phabricator.kde.org/dashboard/view/8/?)