diff --git a/docs/index.rst b/docs/index.rst
index 062bffc..e96d314 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,6 +6,8 @@
 Welcome to Mitel OMMClient2's documentation!
 ============================================
 
+This is the documentation for mitel_ommclient2. To get started stick to the :doc:`manual/client`.
+
 .. toctree::
    :maxdepth: 2
 
diff --git a/docs/manual/connection.rst b/docs/manual/connection.rst
index c317310..984ebf2 100644
--- a/docs/manual/connection.rst
+++ b/docs/manual/connection.rst
@@ -2,7 +2,8 @@ Connection Usage Manual
 =======================
 
 This manual documents the underlying connation infrastructure. If you just wanna
-use the API, please see :doc:`/manual/client` .
+use the API, please see :doc:`/manual/client` . Ideally you don't use to use this
+class directly, except for expanding the clients functionality.
 
 Using connections
 -----------------