docs: note FlushPolicy.MaxFlushSizeFlushPolicy has a better option

BenWhitehead · BenWhitehead · commit 0257fe0027fd · 2025-08-11T15:42:16.000-04:00
Further testing is needed to determine if MaxFlushSizeFlushPolicy can/should be removed all together.
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
@@ -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

Original file line number	Diff line number	Diff line change
`@@ -108,6 +108,9 @@ abstract BufferedWritableByteChannel createBufferedChannel(`
`108`	`108`	`*`
`109`	`109`	`* <p>Instances of this class are immutable and thread safe.`
`110`	`110`	`*`
	`111`	`+ * <p>Instead of this, strategy use {@link FlushPolicy#minFlushSize()}{@code .}{@link`
	`112`	`+ * MinFlushSizeFlushPolicy#withMaxPendingBytes(long) withMaxPendingBytes(long)}`
	`113`	`+ *`
`111`	`114`	`* @since 2.51.0 This new api is in preview and is subject to breaking changes.`
`112`	`115`	`*/`
`113`	`116`	`@Immutable`