diff --git a/src/main/java/com/ninjasquad/springmockk/MockkBean.java b/src/main/java/com/ninjasquad/springmockk/MockkBean.java
index edbcd62..b7bd3f0 100644
--- a/src/main/java/com/ninjasquad/springmockk/MockkBean.java
+++ b/src/main/java/com/ninjasquad/springmockk/MockkBean.java
@@ -16,10 +16,12 @@
  * used as a class level annotation or on fields in either {@code @Configuration} classes,
  * or test classes that are run with the {@link SpringRunner}.
  * <p>
- * Mocks can be registered by type or by {@link #name() bean name}. Any existing single
- * bean of the same type defined in the context will be replaced by the mock. If no
- * existing bean is defined a new one will be added. Dependencies that are known to the
- * application context but are not beans (such as those
+ * Mocks can be registered by type or by {@link #name() bean name}. When registered by
+ * type, any existing single bean of a matching type (including subclasses) in the context
+ * will be replaced by the mock. When registered by name, an existing bean can be
+ * specifically targeted for replacement by a mock. In either case, if no existing bean is
+ * defined a new one will be added. Dependencies that are known to the application context
+ * but are not beans (such as those
  * {@link org.springframework.beans.factory.config.ConfigurableListableBeanFactory#registerResolvableDependency(Class, Object)
  * registered directly}) will not be found and a mocked bean will be added to the context
  * alongside the existing dependency.
diff --git a/src/main/java/com/ninjasquad/springmockk/SpykBean.java b/src/main/java/com/ninjasquad/springmockk/SpykBean.java
index 7dee0a8..6d92416 100644
--- a/src/main/java/com/ninjasquad/springmockk/SpykBean.java
+++ b/src/main/java/com/ninjasquad/springmockk/SpykBean.java
@@ -18,9 +18,9 @@
  * run with the {@link SpringRunner}.
  * <p>
  * Spies can be applied by type or by {@link #name() bean name}. All beans in the context
- * of the same type will be wrapped with the spy. If no existing bean is defined a new one
- * will be added. Dependencies that are known to the application context but are not beans
- * (such as those
+ * of a matching type (including subclasses) will be wrapped with the spy. If no existing
+ * bean is defined a new one will be added. Dependencies that are known to the application
+ * context but are not beans (such as those
  * {@link org.springframework.beans.factory.config.ConfigurableListableBeanFactory#registerResolvableDependency(Class, Object)
  * registered directly}) will not be found and a spied bean will be added to the context
  * alongside the existing dependency.