From 39d3e804bb522a1a739bb7122110fbdfe3601acf Mon Sep 17 00:00:00 2001
From: chenjian2664 <chenjian2664@gmail.com>
Date: Sat, 24 Oct 2026 14:59:55 +0800
Subject: [PATCH] [docs] Correct sidebar instructions for new pages

---
 docs/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index 5e7ba5586c36..93699375a647 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -64,10 +64,10 @@ cd .. && mvn -pl paimon-docs -am package -DskipTests
    ```yaml
    ---
    title: "Page Title"
-   sidebar_position: 5
    ---
    ```
-3. The page will automatically appear in the sidebar based on `sidebar_position`
+3. Add the page's document ID to the appropriate category in `sidebars.js`.
+   Sidebar entries and their order are configured explicitly.
 
 ## Using Tabs