diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index f57a4983..b747c0bf 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -586,6 +586,15 @@
plugins).
+
+ Using an object path of / is allowed, but
+ recommended against, as it makes versioning of interfaces hard. Any
+ signals emitted from a D-Bus object have the service’s unique bus name
+ associated with them, rather than its well-known name. This means that
+ receipients of the signals must rely entirely on the signal name and
+ object path to work out which interface the signal originated from.
+
+
For instance, if the owner of example.com is
developing a D-Bus API for a music player, they might use the