diff --git a/akka-docs/java/dispatchers.rst b/akka-docs/java/dispatchers.rst
index fceb94abbc..2dcd5049c5 100644
--- a/akka-docs/java/dispatchers.rst
+++ b/akka-docs/java/dispatchers.rst
@@ -55,6 +55,13 @@ Default values are taken from ``default-dispatcher``, i.e. all options doesn't n
 :ref:`configuration` for the default values of the ``default-dispatcher``. You can also override
 the values for the ``default-dispatcher`` in your configuration.
 
+.. note::
+
+  It should be noted that the ``dispatcher-id`` used in :class:`Props` is in
+  fact an absolute path into the configuration object, i.e. you can declare a
+  dispatcher configuration nested within other configuration objects and refer
+  to it like so: ``"my.config.object.myAwesomeDispatcher"``
+
 There are two different executor services:
 
 * executor = "fork-join-executor", ``ExecutorService`` based on ForkJoinPool (jsr166y). This is used by default for
diff --git a/akka-docs/scala/dispatchers.rst b/akka-docs/scala/dispatchers.rst
index c6e6ae23e3..50807fbc55 100644
--- a/akka-docs/scala/dispatchers.rst
+++ b/akka-docs/scala/dispatchers.rst
@@ -54,6 +54,13 @@ Default values are taken from ``default-dispatcher``, i.e. all options doesn't n
 :ref:`configuration` for the default values of the ``default-dispatcher``. You can also override
 the values for the ``default-dispatcher`` in your configuration.
 
+.. note::
+
+  It should be noted that the ``dispatcher-id`` used in :class:`Props` is in
+  fact an absolute path into the configuration object, i.e. you can declare a
+  dispatcher configuration nested within other configuration objects and refer
+  to it like so: ``"my.config.object.myAwesomeDispatcher"``
+
 There are two different executor services:
 
 * executor = "fork-join-executor", ``ExecutorService`` based on ForkJoinPool (jsr166y). This is used by default for