Clearer pageSizeHint description (Azure#26017)

Author: pakrym

sdk/core/Azure.Core/src/AsyncPageable.cs

@@ -79,8 +79,8 @@ protected AsyncPageable(CancellationToken cancellationToken) =>
         /// begin paging from the beginning.
         /// </param>
         /// <param name="pageSizeHint">
-        /// The size of <see cref="Page{T}"/>s that should be requested (from
-        /// service operations that support it).
+        /// The number of items per <see cref="Page{T}"/> that should be requested (from
+        /// service operations that support it). It's not guaranteed that the value will be respected.
         /// </param>
         /// <returns>
         /// An async sequence of <see cref="Page{T}"/>s.

sdk/core/Azure.Core/src/Pageable.cs

@@ -50,8 +50,8 @@ protected Pageable(CancellationToken cancellationToken) =>
         /// begin paging from the beginning.
         /// </param>
         /// <param name="pageSizeHint">
-        /// The size of <see cref="Page{T}"/>s that should be requested (from
-        /// service operations that support it).
+        /// The number of items per <see cref="Page{T}"/> that should be requested (from
+        /// service operations that support it). It's not guaranteed that the value will be respected.
         /// </param>
         /// <returns>
         /// An async sequence of <see cref="Page{T}"/>s.