diff --git a/docs/source/1.0/guides/building-models/build-config.rst b/docs/source/1.0/guides/building-models/build-config.rst
index 0e9b9a814..9ed68cd94 100644
--- a/docs/source/1.0/guides/building-models/build-config.rst
+++ b/docs/source/1.0/guides/building-models/build-config.rst
@@ -894,9 +894,13 @@ namespace. Shapes not connected to a service will not be flattened.
         separate :ref:`service closures <service-closure>`.
 
 The following example will flatten the namespaces of the shapes connected to
-the ``ns.bar#MyService`` service into the target namespace, ``ns.foo``. Shapes
-tagged with ``baz`` or ``qux`` will also be flattened into the ``ns.foo``
-namespace, so long as they don't conflict with a shape within the :ref:`service closure <service-closure>`.
+the ``ns.bar#MyService`` service into the target namespace, ``ns.foo``. All
+shapes within :ref:`service closure <service-closure>` with be flattened into
+the target namespace, including shapes that have been renamed to disambiguate
+them through the service shape's ``rename`` property. Shapes tagged with
+``baz`` or ``qux`` will also be flattened into the ``ns.foo`` namespace, so
+long as they don't conflict with a shape within the
+:ref:`service closure <service-closure>`.
 
 .. tabs::