diff --git a/README.rst b/README.rst
index fa725a4a..9e7ef99c 100644
--- a/README.rst
+++ b/README.rst
@@ -40,7 +40,7 @@ Building Coriolis
 
 To build Coriolis, ensure the following prerequisites are met:
 
-* Python 2.7.
+* Python 3.
 * cmake.
 * boost.
 * bison & flex.
@@ -58,17 +58,14 @@ the repository in the right place. Proceed as follow: ::
    ego@home:~$ git clone http://github.com/miloyip/rapidjson
    ego@home:~$ git checkout ec322005072076ef53984462fb4a1075c27c7dfd
    ego@home:~$ cd ~/coriolis-2.x/src
-   ego@home:src$ git clone https://www-soc.lip6.fr/git/coriolis.git
+   ego@home:src$ git clone https://gitlab.lip6.fr/vlsi-eda/coriolis.git
    ego@home:src$ cd coriolis
 
-If you want to use the *devel* branch: ::
-
-    ego@home:coriolis$ git checkout devel
-
 Then, build the tool: ::
 
     ego@home:coriolis$ make install
 
+If you encounter issues, please consult SUPPORT.rst for tips.
 Coriolis gets installed at the root of the following tree: ::
 
     ~/coriolis-2.x/<OS>.<DISTRIB>/Release.Shared/install/
diff --git a/SUPPORT.rst b/SUPPORT.rst
new file mode 100644
index 00000000..ec1ca8e3
--- /dev/null
+++ b/SUPPORT.rst
@@ -0,0 +1,27 @@
+
+=================
+Help and tooltips
+=================
+
+
+Compilation errors
+==================
+
+This section is here to help you with the build process, and help you fix dependency issues or workaround compilation errors if it happens on your distribution.
+
+
+RapidJson
+---------
+
+Some versions of RapidJson do not build with newer compilers, while others build only with newer ones.
+The version provided in README.rst should work for older compilers. Otherwise, consider pulling a newer version.
+
+Qt5
+---
+
+To use Qt5, you should add the --qt5 option to the ccb.py line in Makefile.
+On some distributions, you may need to replace the lines in bootstrap/cmake_modules/FindBootstrap.cmake from ::
+    find_package(Qt5Core         REQUIRED)
+to ::
+    find_package(Qt5 COMPONENTS REQUIRED Core)
+