From 0257fe0027fda46a9c62de07934096e7e38bb24b Mon Sep 17 00:00:00 2001
From: BenWhitehead <BenWhitehead@users.noreply.github.com>
Date: Tue, 5 Aug 2025 15:06:28 -0400
Subject: [PATCH] docs: note FlushPolicy.MaxFlushSizeFlushPolicy has a better
 option

Further testing is needed to determine if MaxFlushSizeFlushPolicy can/should be removed all together.
---
 .../src/main/java/com/google/cloud/storage/FlushPolicy.java    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java
index 0fa7f2319f..bff10fe1d8 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java
@@ -108,6 +108,9 @@ abstract BufferedWritableByteChannel createBufferedChannel(
    *
    * <p>Instances of this class are immutable and thread safe.
    *
+   * <p>Instead of this, strategy use {@link FlushPolicy#minFlushSize()}{@code .}{@link
+   * MinFlushSizeFlushPolicy#withMaxPendingBytes(long) withMaxPendingBytes(long)}
+   *
    * @since 2.51.0 This new api is in preview and is subject to breaking changes.
    */
   @Immutable