diff --git a/packages/flutter/lib/src/cupertino/refresh.dart b/packages/flutter/lib/src/cupertino/refresh.dart
index 3069f7beaa6..607f79165eb 100644
--- a/packages/flutter/lib/src/cupertino/refresh.dart
+++ b/packages/flutter/lib/src/cupertino/refresh.dart
@@ -250,6 +250,10 @@ typedef Future<void> RefreshCallback();
 /// other words, refreshes can't be triggered with lists using
 /// [ClampingScrollPhysics].
 ///
+/// In a typical application, this sliver should be inserted between the app bar
+/// sliver such as [CupertinoSliverNavigationBar] and your main scrollable
+/// content's sliver.
+///
 /// See also:
 ///
 ///  * [CustomScrollView], a typical sliver holding scroll view this control