(fluss) branch main updated: [docs] Improve historical partition restart warning (#4441)

[yu...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

luoyuxia pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fluss.git


The following commit(s) were added to refs/heads/main by this push:
     new e88b1112d [docs] Improve historical partition restart warning (#4441)
e88b1112d is described below

commit e88b1112d0171d9f5ff18331defb952dfd5e316e
Author: yuxia Luo <lu...@alumni.sjtu.edu.cn>
AuthorDate: Tue Sep 29 19:56:58 2026 +0800

    [docs] Improve historical partition restart warning (#4441)
---
 website/docs/table-design/data-distribution/partitioning.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/website/docs/table-design/data-distribution/partitioning.md b/website/docs/table-design/data-distribution/partitioning.md
index 49bfeac21..e525478eb 100644
--- a/website/docs/table-design/data-distribution/partitioning.md
+++ b/website/docs/table-design/data-distribution/partitioning.md
@@ -73,12 +73,6 @@ In this case, when automatic partitioning occurs (Fluss will periodically operat
 
 Before using historical partition access, make sure the [Paimon server-side setup](../../streaming-lakehouse/datalake-formats/paimon.md#historical-partition-access-setup) is completed.
 
-:::warning
-**After changing `table.datalake.historical-partition.enabled`, restart existing writer and lookup
-jobs that need historical partition access so that their clients load the updated table
-configuration.**
-:::
-
 Auto partitioning eventually removes partitions that fall outside the configured retention window.
 After an original Fluss partition is removed, late records cannot be written to it and primary-key
 lookups cannot find its rows in Fluss, even when the existing data has already been tiered to
@@ -94,6 +88,12 @@ ALTER TABLE my_partitioned_table SET (
 );
 ```
 
+:::warning
+After enabling or disabling `table.datalake.historical-partition.enabled`, restart any existing
+writer and lookup jobs that require historical partition access so that their clients reload the
+updated table configuration.
+:::
+
 When enabled, the Coordinator creates and retains an internal `__historical__` system partition:
 
 - **Writes:** Log tables and primary-key tables route records for expired partitions through the