diff --git a/docs/index.rst b/docs/index.rst
index 67c31f41..551ebe64 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -3,6 +3,12 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
+.. note::
+
+   This is the documentation of the upcoming 2.0 release of paho-mqtt (already
+   available as pre-release). For 1.6.x release of paho-mqtt, see the
+   Github README.
+
 .. include:: ../README.rst
 
 .. toctree::