diff --git a/lib/rsvp/defer.js b/lib/rsvp/defer.js
index 9322a0bb..4571120c 100644
--- a/lib/rsvp/defer.js
+++ b/lib/rsvp/defer.js
@@ -3,7 +3,9 @@ import Promise from "./promise";
 /**
   `defer` returns an object similar to jQuery's `$.Deferred`.
   `defer` should be used when porting over code reliant on `$.Deferred`'s
-  interface. New code should use the `Promise` constructor instead.
+  interface. New code should usually use the `Promise` constructor instead,
+  but `defer` may still be useful in some contexts, especially when writing
+  tests.
 
   The object returned from `defer` is a plain object with three properties: