From 536fcf5d044c116b91912872b744166a02cd35b9 Mon Sep 17 00:00:00 2001
From: Patrick Birch <48594400+patrickbirch@users.noreply.github.com>
Date: Tue, 30 Sep 2025 17:17:53 -0500
Subject: [PATCH] PS-10214 - Document changed ranges of variables in MyRocks
 8.0

 On branch ps-10214-8.0
	modified:   docs/variables.md
---
 docs/variables.md | 42 +++++++++++++++++++++++++++++++++++-------
 1 file changed, 35 insertions(+), 7 deletions(-)

diff --git a/docs/variables.md b/docs/variables.md
index ebb71274e3e..9736c41ba4e 100644
--- a/docs/variables.md
+++ b/docs/variables.md
@@ -490,9 +490,16 @@ Allowed range is from `1` to `2147483647`.
 | Data type    | Numeric              |
 | Default      | 16 KB                |
 
-Specifies the size of the data block for reading RocksDB data files.
+Specifies the size of the data blocks used for storing and reading RocksDB data files. Larger block sizes can improve compression efficiency and reduce metadata overhead, but may increase memory usage and read amplification.
+
 The default value is `16 KB`.
-The allowed range is from `1024` to `18446744073709551615` bytes.
+The allowed range is from `1024` to `4294967296` bytes (4GiB).
+
+#### Version change
+
+As of Percona Server for MySQL 8.0.44-35, the maximum value has been reduced from `18446744073709551615` bytes to `4294967296` bytes (4GiB).
+
+For versions before 8.0.44-35, the allowed range is from `1024` to `18446744073709551615` bytes.
 
 ### `rocksdb_block_size_deviation`
 
@@ -1186,7 +1193,13 @@ through before assuming deadlock.
 | Data type | UINT |
 | Default | 2 |
 
-The cardinality multiplier used in tests. The minimum value is 0. The maxium value is 2147483647 (INT_MAX).
+The cardinality multiplier used in tests. The minimum value is 1. The maxium value is 2147483647 (INT_MAX).
+
+#### Version change
+
+As of Percona Server for MySQL 8.0.44-35, the minimum value has been changed from 0 to 1.
+
+For versions before 8.0.44-35, the minimum value is 0.
 
 ### `rocksdb_debug_manual_compaction_delay`
 
@@ -1564,7 +1577,7 @@ The variable was implemented in [Percona Server for MySQL 8.0.20-11](release-not
 
 #### Version changes
 
-The variable was implemented in [Percona Server for MySQL 8.0.25-15](release-notes/Percona-Server-8.0.25-15.md#id1).
+The variable was implemented in [Percona Server for MySQL 8.0.25-15](./release-notes/Percona-Server-8.0.25-15.md).
 
 #### Improving Write Throughput with Pipelined Writes
 
@@ -2007,8 +2020,14 @@ When enabled, this option allows index key prefixes longer than 767 bytes (up to
 | Default      | 1000                        |
 
 Specifies the maximum number of info log files to keep.
-Default value is `1000`.
-Allowed range is from `1` to `18446744073709551615`.
+The default number is `1000`.
+The allowed range is from `1` to `18446744073709551615`.
+
+#### Version change
+
+As of Percona Server for MySQL 8.0.44-35, Percona Server sets the minimum value to `1`.
+
+For versions before 8.0.44-35, the minimum value was `0`.
 
 ### `rocksdb_lock_scanned_rows`
 
@@ -2227,7 +2246,16 @@ Tracks the history for at most `rockdb_mx_compaction_history` completed compacti
 
 This variable has been implemented in [Percona Server for MySQL 8.0.36-28](.//release-notes/8.0.36-28.md).
 
-This variable sets `DBOptions::max_file_opening_threads` for RocksDB. The default value is `16`. The minimum value is `1` and the maximum value is 2147483647 (`INT_MAX`).
+This variable sets `DBOptions::max_file_opening_threads` for RocksDB, controlling the maximum number of threads that can be used to open files concurrently. This helps improve performance when opening multiple files simultaneously.
+
+The default value is `16`.
+The minimum value is `1` and the maximum value is `262144`.
+
+#### Version change
+
+As of Percona Server for MySQL 8.0.44-35, the maximum value has been reduced from `2147483647` (`INT_MAX`) to `262144`.
+
+For versions before 8.0.44-35, the maximum value was `2147483647` (`INT_MAX`).
 
 ### `rocksdb_max_latest_deadlocks`