diff --git a/docs/index.rst b/docs/index.rst
index c1ab4287..6297925a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -225,8 +225,10 @@ two loggers: ``elasticsearch`` and ``elasticsearch.trace``. ``elasticsearch``
 is used by the client to log standard activity, depending on the log level.
 ``elasticsearch.trace`` can be used to log requests to the server in the form
 of ``curl`` commands using pretty-printed json that can then be executed from
-command line. If the trace logger has not been configured already it is set to
-`propagate=False` so it needs to be activated separately.
+command line. Because it is designed to be shared (for example to demonstrate
+an issue) it also just uses ``localhost:9200`` as the address instead of the
+actuall address of the host. If the trace logger has not been configured
+already it is set to `propagate=False` so it needs to be activated separately.
 
 .. _logging library: http://docs.python.org/3.3/library/logging.html