diff --git a/botocore/paginate.py b/botocore/paginate.py
index 2678ef8432..a4d45eefad 100644
--- a/botocore/paginate.py
+++ b/botocore/paginate.py
@@ -185,6 +185,11 @@ def get_paginator(self, operation_name):
 
 
 class PageIterator:
+    """An iterable object to pagiante API results.
+    Please note it is NOT a python iterator.
+    Use ``iter`` to wrap this as a generator.
+    """
+
     def __init__(
         self,
         method,