fix docs

wuchong · wuchong · commit 8e88882cf34c · 2025-12-23T23:18:19.000+08:00
diff --git a/website/docs/engine-flink/datastream.mdx b/website/docs/engine-flink/datastream.mdx
@@ -1,6 +1,6 @@
 ---
 title: "DataStream API"
-sidebar_position: 7
+sidebar_position: 8
 ---
 
 # DataStream API
diff --git a/website/docs/engine-flink/ddl.md b/website/docs/engine-flink/ddl.md
@@ -27,7 +27,7 @@ The following properties can be set if using the Fluss catalog:
 | bootstrap.servers              | required | (none)    | Comma separated list of Fluss servers.                                                                                                                                                                                 |
 | default-database               | optional | fluss     | The default database to use when switching to this catalog.                                                                                                                                                            |
 | client.security.protocol       | optional | PLAINTEXT | The security protocol used to communicate with brokers. Currently, only `PLAINTEXT` and `SASL` are supported, the configuration value is case insensitive.                                                             |
-| `client.security.{protocol}.*` | optional | (none)    | Client-side configuration properties for a specific authentication protocol. E.g., client.security.sasl.jaas.config. More Details in [authentication](../../security/authentication.md)                                   |
+| `client.security.{protocol}.*` | optional | (none)    | Client-side configuration properties for a specific authentication protocol. E.g., client.security.sasl.jaas.config. More Details in [authentication](../security/authentication.md)                                   |
 | `{lake-format}.*`              | optional | (none)    | Extra properties to be passed to the lake catalog. This is useful for configuring sensitive settings, such as the username and password required for lake catalog authentication. E.g., `paimon.jdbc.password = pass`. |
 
 The following statements assume that the current catalog has been switched to the Fluss catalog using the `USE CATALOG <catalog_name>` statement.
@@ -125,7 +125,7 @@ CREATE TABLE my_part_log_table (
 Fluss partitioned table supports dynamic partition creation, which means you can write data into a partition without pre-creating it.
 You can use the `INSERT INTO` statement to write data into a partitioned table, and Fluss will automatically create the partition if it does not exist.
 See the [Dynamic Partitioning](table-design/data-distribution/partitioning.md#dynamic-partitioning) for more details.
-But you can still use the [Add Partition](engine-flink/ddl/index.md#add-partition) statement to manually add partitions if needed.
+But you can still use the [Add Partition](engine-flink/ddl.md#add-partition) statement to manually add partitions if needed.
 :::
 
 #### Multi-Fields Partitioned Table
diff --git a/website/docs/engine-flink/delta-joins.md b/website/docs/engine-flink/delta-joins.md
@@ -1,7 +1,7 @@
 ---
 sidebar_label: Delta Joins
 title: Flink Delta Joins
-sidebar_position: 6
+sidebar_position: 7
 ---
 
 # The Delta Join
diff --git a/website/docs/engine-flink/getting-started.md b/website/docs/engine-flink/getting-started.md
@@ -22,19 +22,19 @@ For Flink's Table API, Fluss supports the following features:
 
 | Feature Support                                   | Flink | Notes                                  |
 |---------------------------------------------------|-------|----------------------------------------|
-| [SQL Create Catalog](ddl/index.md#create-catalog)       | ✔️    |                                        |
-| [SQL Create Database](ddl/index.md#create-database)     | ✔️    |                                        |
-| [SQL Drop Database](ddl/index.md#drop-database)         | ✔️    |                                        |
-| [SQL Create Table](ddl/index.md#create-table)           | ✔️    |                                        |
-| [SQL Create Table Like](ddl/index.md#create-table-like) | ✔️    |                                        |
-| [SQL Drop Table](ddl/index.md#drop-table)               | ✔️    |                                        |
-| [SQL Create Materialized Table](ddl/index.md#materialized-table) | ✔️    | Continuous refresh mode only |
-| [SQL Alter Materialized Table](ddl/index.md#alter-materialized-table) | ✔️    | Suspend/Resume support |
-| [SQL Drop Materialized Table](ddl/index.md#drop-materialized-table) | ✔️    |                                        |
-| [SQL Show Partitions](ddl/index.md#show-partitions)     | ✔️    |                                        |
-| [SQL Add Partition](ddl/index.md#add-partition)         | ✔️    |                                        |
-| [SQL Drop Partition](ddl/index.md#drop-partition)       | ✔️    |                                        |
-| [Procedures](ddl/index.md#procedures)                   | ✔️    | ACL management and cluster configuration |
+| [SQL Create Catalog](ddl.md#create-catalog)       | ✔️    |                                        |
+| [SQL Create Database](ddl.md#create-database)     | ✔️    |                                        |
+| [SQL Drop Database](ddl.md#drop-database)         | ✔️    |                                        |
+| [SQL Create Table](ddl.md#create-table)           | ✔️    |                                        |
+| [SQL Create Table Like](ddl.md#create-table-like) | ✔️    |                                        |
+| [SQL Drop Table](ddl.md#drop-table)               | ✔️    |                                        |
+| [SQL Create Materialized Table](ddl.md#materialized-table) | ✔️    | Continuous refresh mode only |
+| [SQL Alter Materialized Table](ddl.md#alter-materialized-table) | ✔️    | Suspend/Resume support |
+| [SQL Drop Materialized Table](ddl.md#drop-materialized-table) | ✔️    |                                        |
+| [SQL Show Partitions](ddl.md#show-partitions)     | ✔️    |                                        |
+| [SQL Add Partition](ddl.md#add-partition)         | ✔️    |                                        |
+| [SQL Drop Partition](ddl.md#drop-partition)       | ✔️    |                                        |
+| [Procedures](ddl.md#procedures)                   | ✔️    | ACL management and cluster configuration |
 | [SQL Select](reads.md)                            | ✔️    | Support both streaming and batch mode. |
 | [SQL Limit](reads.md#limit-read)                  | ✔️    | Only for Log Table                     |
 | [SQL Insert Into](writes.md)                      | ✔️    | Support both streaming and batch mode. |
diff --git a/website/docs/engine-flink/lookups.md b/website/docs/engine-flink/lookups.md
@@ -1,7 +1,7 @@
 ---
 sidebar_label: Lookups
 title: Flink Lookup Joins
-sidebar_position: 5
+sidebar_position: 6
 ---
 
 # Flink Lookup Joins
diff --git a/website/docs/engine-flink/options.md b/website/docs/engine-flink/options.md
@@ -1,6 +1,6 @@
 ---
 title: Connector Options
-sidebar_position: 8
+sidebar_position: 9
 ---
 
 # Connector Options
@@ -57,7 +57,7 @@ Using `ALTER TABLE ... SET` statement to modify the table options. For example,
 ALTER TABLE log_table SET ('table.datalake.enable' = 'true');
 ```
 
-See more details about [ALTER TABLE ... SET](engine-flink/ddl/index.md#set-properties) and [ALTER TABLE ... RESET](engine-flink/ddl/index.md#reset-properties) documentation.
+See more details about [ALTER TABLE ... SET](engine-flink/ddl.md#set-properties) and [ALTER TABLE ... RESET](engine-flink/ddl.md#reset-properties) documentation.
 
 ## Storage Options
 
diff --git a/website/docs/engine-flink/procedures.md b/website/docs/engine-flink/procedures.md
@@ -18,9 +18,9 @@ SHOW PROCEDURES;
 
 ## Access Control Procedures
 
-Fluss provides procedures to manage Access Control Lists (ACLs) for security and authorization.
+Fluss provides procedures to manage Access Control Lists (ACLs) for security and authorization. See the [Security](../security/overview.md) documentation for more details.
 
-## add_acl
+### add_acl
 
 Add an ACL entry to grant permissions to a principal.
 
@@ -69,7 +69,7 @@ CALL sys.add_acl(
 );
 ```
 
-## drop_acl
+### drop_acl
 
 Remove an ACL entry to revoke permissions.
 
@@ -114,7 +114,7 @@ CALL sys.drop_acl(
 );
 ```
 
-## list_acl
+### list_acl
 
 List ACL entries matching the specified filters.
 
@@ -162,7 +162,7 @@ CALL sys.list_acl(
 
 Fluss provides procedures to dynamically manage cluster configurations without requiring a server restart.
 
-## get_cluster_config
+### get_cluster_config
 
 Retrieve cluster configuration values.
 
@@ -200,7 +200,7 @@ CALL sys.get_cluster_config(
 CALL sys.get_cluster_config();
 ```
 
-## set_cluster_config
+### set_cluster_config
 
 Set or delete a cluster configuration dynamically.
 
diff --git a/website/docs/engine-flink/reads.md b/website/docs/engine-flink/reads.md
@@ -1,7 +1,7 @@
 ---
 sidebar_label: Reads
 title: Flink Reads
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 # Flink Reads
diff --git a/website/docs/engine-flink/writes.md b/website/docs/engine-flink/writes.md
@@ -1,7 +1,7 @@
 ---
 sidebar_label: Writes
 title: Flink Writes
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 # Flink Writes
diff --git a/website/docs/maintenance/operations/updating-configs.md b/website/docs/maintenance/operations/updating-configs.md
@@ -18,7 +18,7 @@ Currently, the supported dynamically updatable server configurations include:
 - `kv.rocksdb.shared-rate-limiter.bytes-per-sec`: Control RocksDB flush and compaction write rate shared across all RocksDB instances on the TabletServer. The rate limiter is always enabled. Set to a lower value (e.g., 100MB) to limit the rate, or a very high value to effectively disable rate limiting.
 
 
-You can update the configuration of a cluster with [Java client](#using-java-client) or [Flink Stored Procedures](../../engine-flink/ddl/procedures.md#cluster-configuration-procedures).
+You can update the configuration of a cluster with [Java client](#using-java-client) or [Flink Procedures](../../engine-flink/procedures.md#cluster-configuration-procedures).
 
 ### Using Java Client
 
@@ -48,11 +48,11 @@ The `AlterConfig` class contains three properties:
 
 ### Using Flink Stored Procedures
 
-For certain configurations, Fluss provides convenient Flink stored procedures that can be called directly from Flink SQL. See [Procedures](engine-flink/ddl/procedures.md#cluster-configuration-procedures) for detailed documentation on using `get_cluster_config` and `set_cluster_config` procedures.
+For certain configurations, Fluss provides convenient Flink stored procedures that can be called directly from Flink SQL. See [Procedures](engine-flink/procedures.md#cluster-configuration-procedures) for detailed documentation on using `get_cluster_config` and `set_cluster_config` procedures.
 
 ## Updating Table Configs
 
-The connector options on a table including [Storage Options](engine-flink/options.md#storage-options) can be updated dynamically by [ALTER TABLE ... SET](engine-flink/ddl/index.md#alter-table) statement. See the example below:
+The connector options on a table including [Storage Options](engine-flink/options.md#storage-options) can be updated dynamically by [ALTER TABLE ... SET](engine-flink/ddl.md#alter-table) statement. See the example below:
 
 ```sql
 -- Enable lakehouse storage for the given table
diff --git a/website/docs/table-design/data-distribution/bucketing.md b/website/docs/table-design/data-distribution/bucketing.md
@@ -8,7 +8,7 @@ sidebar_position: 1
 A bucketing strategy is a data distribution technique that divides table data into small pieces 
 and distributes the data to multiple hosts and services.
 
-When creating a Fluss table, you can specify the number of buckets by setting `'bucket.num' = '<num>'` property for the table, see more details in [DDL](engine-flink/ddl/index.md).
+When creating a Fluss table, you can specify the number of buckets by setting `'bucket.num' = '<num>'` property for the table, see more details in [DDL](engine-flink/ddl.md).
 Currently, Fluss supports 3 bucketing strategies: **Hash Bucketing**, **Sticky Bucketing** and **Round-Robin Bucketing**.
 Primary-Key Tables only allow to use **Hash Bucketing**. Log Tables use **Sticky Bucketing** by default but can use other two bucketing strategies.
 
diff --git a/website/docs/table-design/data-distribution/partitioning.md b/website/docs/table-design/data-distribution/partitioning.md
@@ -9,7 +9,7 @@ sidebar_position: 2
 In Fluss, a **Partitioned Table** organizes data based on one or more partition keys, providing a way to improve query performance and manageability for large datasets. Partitions allow the system to divide data into distinct segments, each corresponding to specific values of the partition keys.
 
 For partitioned tables, Fluss supports three strategies of managing partitions.
-   - **Manual management partitions**, user can create new partitions or drop exists partitions. Learn how to create or drop partitions please refer to [Add Partition](/engine-flink/ddl/index.md#add-partition) and [Drop Partition](engine-flink/ddl/index.md#drop-partition).
+   - **Manual management partitions**, user can create new partitions or drop exists partitions. Learn how to create or drop partitions please refer to [Add Partition](engine-flink/ddl.md#add-partition) and [Drop Partition](engine-flink/ddl.md#drop-partition).
    - **Auto management partitions**, the partitions will be created based on the auto partitioning rules configured at the time of table creation, and expired partitions are automatically removed, ensuring data not expanding unlimited. See [Auto Partitioning](table-design/data-distribution/partitioning.md#auto-partitioning).
    - **Dynamic create partitions**, the partitions will be created automatically based on the data being written to the table. See [Dynamic Partitioning](table-design/data-distribution/partitioning.md#dynamic-partitioning).
    
