improve jitter config documentation

Author: HuangZhenQiu

docs/layouts/shortcodes/generated/expert_rocksdb_section.html

@@ -18,7 +18,7 @@
             <td><h5>state.backend.rocksdb.checkpoint.upload-jitter</h5></td>
             <td style="word-wrap: break-word;">0 ms</td>
             <td>Duration</td>
-            <td>The time interval used to create jitter for each checkpoint file upload.</td>
+            <td>The jitter time interval determines the amount of random delay introduced before uploading each checkpoint file. This jitter is applied to help stagger the upload times of state files, thereby introducing a small, randomized delay for each upload operation. The purpose of this mechanism is to avoid simultaneous upload bursts, which could otherwise overwhelm the remote storage system. By distributing the upload requests more evenly over time, jitter helps maintain system stability and prevents potential performance degradation during checkpoint completion. It is therefore recommended to configure the jitter interval at the seconds level, ensuring a balanced trade-off between randomness and upload efficiency.</td>
         </tr>
         <tr>
             <td><h5>state.backend.rocksdb.localdir</h5></td>

docs/layouts/shortcodes/generated/rocksdb_configuration.html

@@ -18,7 +18,7 @@
             <td><h5>state.backend.rocksdb.checkpoint.upload-jitter</h5></td>
             <td style="word-wrap: break-word;">0 ms</td>
             <td>Duration</td>
-            <td>The time interval used to create jitter for each checkpoint file upload.</td>
+            <td>The jitter time interval determines the amount of random delay introduced before uploading each checkpoint file. This jitter is applied to help stagger the upload times of state files, thereby introducing a small, randomized delay for each upload operation. The purpose of this mechanism is to avoid simultaneous upload bursts, which could otherwise overwhelm the remote storage system. By distributing the upload requests more evenly over time, jitter helps maintain system stability and prevents potential performance degradation during checkpoint completion. It is therefore recommended to configure the jitter interval at the seconds level, ensuring a balanced trade-off between randomness and upload efficiency.</td>
         </tr>
         <tr>
             <td><h5>state.backend.rocksdb.localdir</h5></td>

flink-state-backends/flink-statebackend-rocksdb/src/main/java/org/apache/flink/state/rocksdb/RocksDBOptions.java

@@ -100,7 +100,13 @@ public class RocksDBOptions {
                     .durationType()
                     .defaultValue(Duration.ZERO)
                     .withDescription(
-                            "The time interval used to create jitter for each checkpoint file upload.");
+                            "The jitter time interval determines the amount of random delay introduced before uploading each checkpoint file. "
+                                    + "This jitter is applied to help stagger the upload times of state files, thereby introducing a small, "
+                                    + "randomized delay for each upload operation. The purpose of this mechanism is to avoid simultaneous upload bursts, "
+                                    + "which could otherwise overwhelm the remote storage system. By distributing the upload requests more evenly over time, "
+                                    + "jitter helps maintain system stability and prevents potential performance degradation during checkpoint completion. "
+                                    + "It is therefore recommended to configure the jitter interval at the seconds level, ensuring a balanced trade-off "
+                                    + "between randomness and upload efficiency.");
 
     /** The predefined settings for RocksDB DBOptions and ColumnFamilyOptions by Flink community. */
     @Documentation.Section(Documentation.Sections.EXPERT_ROCKSDB)