risingwavelabs · WanYixian · Sep 25, 2024 · Sep 23, 2024 · Sep 23, 2024 · Sep 23, 2024
diff --git a/docs/sql/commands/sql-comment-on.md b/docs/sql/commands/sql-comment-on.md
@@ -1,7 +1,7 @@
 ---
 id: sql-comment-on
 title: COMMENT ON
-description: Add comments on tables or columns
+description: Add comments on tables or columns.
 slug: /sql-comment-on
 ---
 <head>

diff --git a/docs/sql/commands/sql-create-secret.md b/docs/sql/commands/sql-create-secret.md
@@ -1,7 +1,7 @@
 ---
 id: sql-create-secret
 title: CREATE SECRET
-description: Create a secret to store crediencials.
+description: Create a secret to store credentials.
 slug: /sql-create-secret
 ---
 <head>

diff --git a/docs/sql/commands/sql-create-sink.md b/docs/sql/commands/sql-create-sink.md
@@ -1,7 +1,7 @@
 ---
 id: sql-create-sink
 title: CREATE SINK
-description: Create a sink.
+description: Deliver data processed in RisingWave to the sink.
 slug: /sql-create-sink
 ---
 <head>

diff --git a/docs/sql/commands/sql-set-background-ddl.md b/docs/sql/commands/sql-set-background-ddl.md
@@ -1,7 +1,7 @@
 ---
 id: sql-set-background-ddl
 title: SET BACKGROUND_DDL
-description: Run Data Definition Language (DDL) operations in the background.
+description: Run Data Definition Language operations in the background.
 slug: /sql-set-background-ddl
 ---
 <head>

diff --git a/docs/sql/commands/sql-set-time-zone.md b/docs/sql/commands/sql-set-time-zone.md
@@ -1,7 +1,7 @@
 ---
 id: sql-set-time-zone
 title: SET TIME ZONE
-description: Set time zone.
+description: Specify time zone as needed.
 slug: /sql-set-time-zone
 ---
 <head>

diff --git a/docs/sql/commands/sql-start-transaction.md b/docs/sql/commands/sql-start-transaction.md
@@ -1,7 +1,7 @@
 ---
 id: sql-start-transaction
 title: START TRANSACTION
-description: Start a transaction.
+description: Start a read-only transaction.
 slug: /sql-start-transaction
 ---
 <head>

diff --git a/docs/sql/query-syntax/query-syntax-from-clause.md b/docs/sql/query-syntax/query-syntax-from-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-from-clause
 slug: /query-syntax-from-clause
 title: FROM clause
+description: Specify the data source for a query.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-from-clause/" />

diff --git a/docs/sql/query-syntax/query-syntax-generated-columns.md b/docs/sql/query-syntax/query-syntax-generated-columns.md
@@ -2,6 +2,7 @@
 id: query-syntax-generated-columns
 slug: /query-syntax-generated-columns
 title: Generated columns
+description: Generated from other columns in a table or source.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-generated-columns/" />

diff --git a/docs/sql/query-syntax/query-syntax-group-by-clause.md b/docs/sql/query-syntax/query-syntax-group-by-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-group-by-clause
 slug: /query-syntax-group-by-clause
 title: GROUP BY clause
+description: Group rows with similar values.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-group-by-clause/" />

diff --git a/docs/sql/query-syntax/query-syntax-having-clause.md b/docs/sql/query-syntax/query-syntax-having-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-having-clause
 slug: /query-syntax-having-clause
 title: HAVING clause
+description: Filter results based on specified conditions.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-having-clause/" />

diff --git a/docs/sql/query-syntax/query-syntax-join-clause.md b/docs/sql/query-syntax/query-syntax-join-clause.md
@@ -2,6 +2,8 @@
 id: query-syntax-join-clause
 slug: /query-syntax-join-clause
 title: Joins
+Description: Combine the results of tables by matching column values.
+
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-join-clause/" />

diff --git a/docs/sql/query-syntax/query-syntax-limit-clause.md b/docs/sql/query-syntax/query-syntax-limit-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-limit-clause
 slug: /query-syntax-limit-clause
 title: LIMIT clause
+description: Restrict the number of rows fetched.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-limit-clause/" />

diff --git a/docs/sql/query-syntax/query-syntax-literals.md b/docs/sql/query-syntax/query-syntax-literals.md
@@ -2,6 +2,7 @@
 id: query-syntax-literals
 slug: /query-syntax-literals
 title: Literals
+description: Enhance data representation accuracy.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-literals/" />

diff --git a/docs/sql/query-syntax/query-syntax-order-by-clause.md b/docs/sql/query-syntax/query-syntax-order-by-clause.md
@@ -1,7 +1,7 @@
 ---
 id: query-syntax-order-by-clause
 title: ORDER BY clause
-description: Use the ORDER BY clause to sort the result set of a query.
+description: Sort the result set of a query.
 slug: /query-syntax-order-by-clause
 ---
 <head>

diff --git a/docs/sql/query-syntax/query-syntax-set-operations.md b/docs/sql/query-syntax/query-syntax-set-operations.md
@@ -2,6 +2,7 @@
 id: query-syntax-set-operations
 slug: /query-syntax-set-operations
 title: Set operations
+description: Combine query results.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-set-operations/" />

diff --git a/docs/sql/query-syntax/query-syntax-value-exp.md b/docs/sql/query-syntax/query-syntax-value-exp.md
@@ -2,6 +2,7 @@
 id: query-syntax-value-exp
 slug: /query-syntax-value-exp
 title: Value expressions
+description: Represent fixed values in SQL commands.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-value-exp/" />

diff --git a/docs/sql/query-syntax/query-syntax-values-clause.md b/docs/sql/query-syntax/query-syntax-values-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-values-clause
 
 title: VALUES clause
+description: Generate one or more rows of data as a table expression.
 ---
 
 In RisingWave, the `VALUES` clause is used to generate one or more rows of data as a table expression. It is commonly used in SQL queries to create temporary tables or to insert data into a table.

diff --git a/docs/sql/query-syntax/query-syntax-where-clause.md b/docs/sql/query-syntax/query-syntax-where-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-where-clause
 slug: /query-syntax-where-clause
 title: WHERE clause
+description: Specify any conditions or filters.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-where-clause/" />

diff --git a/docs/sql/query-syntax/query-syntax-with-clause.md b/docs/sql/query-syntax/query-syntax-with-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-with-clause
 slug: /query-syntax-with-clause
 title: WITH clause
+description: Add supplemental statements for a query.
 ---
 <head>
   <link rel="canonical" href="https://docs.risingwave.com/docs/current/query-syntax-with-clause/" />

diff --git a/docs/sql/query-syntax/query-syntax-with-ordinality-clause.md b/docs/sql/query-syntax/query-syntax-with-ordinality-clause.md
@@ -2,6 +2,7 @@
 id: query-syntax-with-ordinality-clause
 slug: /query-syntax-with-ordinality-clause
 title: WITH ORDINALITY clause
+description: Add an additional integer column to the table.
 ---
 
 The `WITH ORDINALITY` clause can be used with set functions in the `FROM` clause of a query. An additional integer column will be added to the table, which numbers the rows returned by the function, starting from 1. By default, the generated column is named `ordinality`.

diff --git a/sidebars.ts b/sidebars.ts
@@ -681,69 +681,8 @@ const sidebars: SidebarsConfig = {
               },
               items: [
                 {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-literals",
-                  label: "Literals",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-value-exp",
-                  label: "Value expressions",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-generated-columns",
-                  label: "Generated columns",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-from-clause",
-                  label: "FROM clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-where-clause",
-                  label: "WHERE clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-group-by-clause",
-                  label: "GROUP BY clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-having-clause",
-                  label: "HAVING clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-order-by-clause",
-                  label: "ORDER BY clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-limit-clause",
-                  label: "LIMIT clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-values-clause",
-                  label: "VALUES clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-set-operations",
-                  label: "Set operations",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-with-clause",
-                  label: "WITH clause",
-                },
-                {
-                  type: "doc",
-                  id: "sql/query-syntax/query-syntax-with-ordinality-clause",
-                  label: "WITH ORDINALITY clause",
+                  type: "autogenerated",
+                  dirName: "sql/query-syntax",
                 },
               ],
             },