diff --git a/apollo-ios-codegen/Sources/IR/IR+NamedFragment.swift b/apollo-ios-codegen/Sources/IR/IR+NamedFragment.swift
index a8c801dab..493a96165 100644
--- a/apollo-ios-codegen/Sources/IR/IR+NamedFragment.swift
+++ b/apollo-ios-codegen/Sources/IR/IR+NamedFragment.swift
@@ -8,6 +8,8 @@ public class NamedFragment: Hashable, CustomDebugStringConvertible {
   /// All of the fragments that are referenced by this fragment's selection set.
   public let referencedFragments: OrderedSet<NamedFragment>
 
+  /// `True` if any selection set, or nested selection set, within the fragment contains any
+  /// fragment marked with the `@defer` directive.
   public let hasDeferredFragments: Bool
 
   /// All of the Entities that exist in the fragment's selection set,
diff --git a/apollo-ios-codegen/Sources/IR/IR+Operation.swift b/apollo-ios-codegen/Sources/IR/IR+Operation.swift
index 55a2ec96d..d572869f5 100644
--- a/apollo-ios-codegen/Sources/IR/IR+Operation.swift
+++ b/apollo-ios-codegen/Sources/IR/IR+Operation.swift
@@ -11,7 +11,8 @@ public class Operation {
   /// All of the fragments that are referenced by this operation's selection set.
   public let referencedFragments: OrderedSet<NamedFragment>
 
-  /// `True` if the selection set contains any fragments marked with the `@defer` directive.
+  /// `True` if any selection set, or nested selection set, within the operation contains any
+  /// fragment marked with the `@defer` directive.
   public let hasDeferredFragments: Bool
 
   init(
diff --git a/apollo-ios/Sources/ApolloAPI/GraphQLOperation.swift b/apollo-ios/Sources/ApolloAPI/GraphQLOperation.swift
index e25c57475..afbd73399 100644
--- a/apollo-ios/Sources/ApolloAPI/GraphQLOperation.swift
+++ b/apollo-ios/Sources/ApolloAPI/GraphQLOperation.swift
@@ -71,6 +71,8 @@ public extension GraphQLOperation {
     return nil
   }
 
+  /// `True` if any selection set, or nested selection set, within the operation contains any
+  /// fragment marked with the `@defer` directive.
   static var hasDeferredFragments: Bool {
     false
   }