diff --git a/docs/decorators.rst b/docs/decorators.rst
index 00eb386..d419507 100644
--- a/docs/decorators.rst
+++ b/docs/decorators.rst
@@ -126,7 +126,7 @@ being able to be dropped in the latter.
 
     def with_optional_arguments(wrapped=None, myarg1=1, myarg2=2):
         if wrapped is None:
-            return functools.partial(with_optional_arguments,
+            return wrapt.PartialCallableObjectProxy(with_optional_arguments,
                     myarg1=myarg1, myarg2=myarg2)
 
         @wrapt.decorator
@@ -155,7 +155,7 @@ be enforced using the keyword only argument syntax.
 
     def with_optional_arguments(wrapped=None, *, myarg1=1, myarg2=2):
         if wrapped is None:
-            return functools.partial(with_optional_arguments,
+            return wrapt.PartialCallableObjectProxy(with_optional_arguments,
                     myarg1=myarg1, myarg2=myarg2)
 
         @wrapt.decorator
@@ -164,6 +164,10 @@ be enforced using the keyword only argument syntax.
 
         return wrapper(wrapped)
 
+The ``wrapt.PartialCallableObjectProxy()`` object is an implementation of
+``functools.partial()`` which uses wrapt and preserves introspection for the
+wrapped callable object.
+
 Processing Function Arguments
 -----------------------------