yugabyte · premkumr · Sep 17, 2024 · Sep 24, 2024 · Sep 24, 2024
diff --git a/docs/config/_default/menus.toml b/docs/config/_default/menus.toml
@@ -492,8 +492,48 @@
     showSection = true
 
 [[preview]]
-  name = "Reference"
+  name = "YSQL"
   weight = 12
+  identifier = "api-ysql"
+  url = "/preview/api/ysql/"
+  [preview.params]
+    showSection = true
+
+[[preview]]
+  name = "YCQL"
+  weight = 13
+  identifier = "api-cassandra"
+  url = "/preview/api/ycql/"
+  [preview.params]
+    showSection = true
+
+[[preview]]
+  name = "Statements"
+  weight = 14
+  parent = "api-cassandra"
+  identifier = "ycql-statements"
+  [preview.params]
+    showSection = true
+
+[[preview]]
+  name = "Data Types"
+  weight = 15
+  parent = "api-cassandra"
+  identifier = "ycql-datatypes"
+  [preview.params]
+    showSection = true
+
+[[preview]]
+  name = "Functions & Expressions"
+  weight = 16
+  parent = "api-cassandra"
+  identifier = "ycql-expressions"
+  [preview.params]
+    showSection = true
+
+[[preview]]
+  name = "Reference"
+  weight = 20
   identifier = "reference"
   [preview.params]
     showSection = true
@@ -505,7 +545,7 @@
 
 [[preview]]
   name = "Contribute"
-  weight = 13
+  weight = 30
   identifier = "contribute"
   url = "/preview/contribute/"
   [preview.params]

diff --git a/docs/content/preview/api/ycql/_index.md b/docs/content/preview/api/ycql/_index.md
@@ -6,13 +6,6 @@ description: YCQL is a semi-relational API that is best fit for internet-scale O
 summary: Reference for the YCQL API
 image: /images/section_icons/api/ycql.png
 headcontent: Cassandra-compatible API
-menu:
-  preview:
-    parent: api
-    identifier: api-cassandra
-    weight: 10
-    params:
-      classes: separator
 aliases:
   - /preview/api/ycql/
 showRightNav: true

diff --git a/docs/content/preview/api/ycql/batch.md b/docs/content/preview/api/ycql/batch.md
@@ -6,7 +6,7 @@ summary: Execute multiple DML in 1 request
 description: Use batch to update multiple rows in 1 request.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 19991
 type: docs
 ---

diff --git a/docs/content/preview/api/ycql/ddl_alter_keyspace.md b/docs/content/preview/api/ycql/ddl_alter_keyspace.md
@@ -5,7 +5,7 @@ linkTitle: ALTER KEYSPACE
 description: Use the ALTER KEYSPACE statement to change the properties of an existing keyspace.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1200
 aliases:
   - /preview/api/cassandra/ddl_alter_keyspace

diff --git a/docs/content/preview/api/ycql/ddl_alter_role.md b/docs/content/preview/api/ycql/ddl_alter_role.md
@@ -5,7 +5,7 @@ linkTitle: ALTER ROLE
 description: Use the ALTER ROLE statement to change the properties of an existing role.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1210
 aliases:
   - /preview/api/cassandra/ddl_alter_role

diff --git a/docs/content/preview/api/ycql/ddl_alter_table.md b/docs/content/preview/api/ycql/ddl_alter_table.md
@@ -5,7 +5,7 @@ linkTitle: ALTER TABLE
 description: Use the ALTER TABLE statement to change the schema or definition of an existing table.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1220
 aliases:
   - /preview/api/cassandra/ddl_alter_table

diff --git a/docs/content/preview/api/ycql/ddl_create_index.md b/docs/content/preview/api/ycql/ddl_create_index.md
@@ -6,7 +6,7 @@ summary: Create a new index on a table
 description: Use the CREATE INDEX statement to create a new index on a table.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1225
 aliases:
   - /preview/api/ycql/ddl_create_index

diff --git a/docs/content/preview/api/ycql/ddl_create_keyspace.md b/docs/content/preview/api/ycql/ddl_create_keyspace.md
@@ -5,7 +5,7 @@ linkTitle: CREATE KEYSPACE
 description: Use the CREATE KEYSPACE statement to create a keyspace that functions as a grouping mechanism for database objects, such as tables or types.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1230
 aliases:
   - /preview/api/cassandra/ddl_create_keyspace

diff --git a/docs/content/preview/api/ycql/ddl_create_role.md b/docs/content/preview/api/ycql/ddl_create_role.md
@@ -5,7 +5,7 @@ linkTitle: CREATE ROLE
 description: Use the `CREATE ROLE` statement to create a new role that is used to authenticate into YCQL and as a group of permissions used to restrict operations on the database objects.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1235
 aliases:
   - /preview/api/cassandra/ddl_create_role

diff --git a/docs/content/preview/api/ycql/ddl_create_table.md b/docs/content/preview/api/ycql/ddl_create_table.md
@@ -5,7 +5,7 @@ linkTitle: CREATE TABLE
 description: Use the CREATE TABLE statement to create a new table in a keyspace.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1240
 aliases:
   - /preview/api/ycql/ddl_create_table

diff --git a/docs/content/preview/api/ycql/ddl_create_type.md b/docs/content/preview/api/ycql/ddl_create_type.md
@@ -5,7 +5,7 @@ linkTitle: CREATE TYPE
 description: Use the CREATE TYPE statement to create a new user-defined data type in a keyspace.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1250
 aliases:
   - /preview/api/cassandra/ddl_create_type

diff --git a/docs/content/preview/api/ycql/ddl_drop_index.md b/docs/content/preview/api/ycql/ddl_drop_index.md
@@ -5,7 +5,7 @@ linkTitle: DROP INDEX
 description: Use the DROP INDEX statement to remove an index and all of its data from the database.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1255
 aliases:
   - /preview/api/cassandra/ddl_drop_index

diff --git a/docs/content/preview/api/ycql/ddl_drop_keyspace.md b/docs/content/preview/api/ycql/ddl_drop_keyspace.md
@@ -5,7 +5,7 @@ linkTitle: DROP KEYSPACE
 description: Use the DROP KEYSPACE statement to remove a keyspace from the system.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1260
 aliases:
   - /preview/api/cassandra/ddl_drop_keyspace

diff --git a/docs/content/preview/api/ycql/ddl_drop_role.md b/docs/content/preview/api/ycql/ddl_drop_role.md
@@ -5,7 +5,7 @@ linkTitle: DROP ROLE
 description: Use the DROP ROLE statement to delete an existing role.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1265
 aliases:
   - /preview/api/cassandra/ddl_drop_role

diff --git a/docs/content/preview/api/ycql/ddl_drop_table.md b/docs/content/preview/api/ycql/ddl_drop_table.md
@@ -5,7 +5,7 @@ linkTitle: DROP TABLE
 description: Use the DROP TABLE statement to remove a table and all of its data from the database.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1270
 aliases:
   - /preview/api/cassandra/ddl_drop_table

diff --git a/docs/content/preview/api/ycql/ddl_drop_type.md b/docs/content/preview/api/ycql/ddl_drop_type.md
@@ -5,7 +5,7 @@ linkTitle: DROP TYPE
 description: Use the DROP TYPE statement to remove an existing user-defined data type.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1280
 aliases:
   - /preview/api/cassandra/ddl_drop_type

diff --git a/docs/content/preview/api/ycql/ddl_grant_permission.md b/docs/content/preview/api/ycql/ddl_grant_permission.md
@@ -5,7 +5,7 @@ linkTitle: GRANT PERMISSION
 description: Use the GRANT PERMISSION statement to grant a permission (or all the available permissions) to a role.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1281
 aliases:
   - /preview/api/cassandra/ddl_grant_permission

diff --git a/docs/content/preview/api/ycql/ddl_grant_role.md b/docs/content/preview/api/ycql/ddl_grant_role.md
@@ -5,7 +5,7 @@ linkTitle: GRANT ROLE
 description: Use the GRANT ROLE statement to grant a role's permissions and SUPERUSER status to another role.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1282
 aliases:
   - /preview/api/cassandra/ddl_grant_role

diff --git a/docs/content/preview/api/ycql/ddl_revoke_permission.md b/docs/content/preview/api/ycql/ddl_revoke_permission.md
@@ -5,7 +5,7 @@ linkTitle: REVOKE PERMISSION
 description: Use the REVOKE PERMISSION statement to revoke a permission (or all the granted permissions) from a role.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1283
 aliases:
   - /preview/api/cassandra/ddl_revoke_permission

diff --git a/docs/content/preview/api/ycql/ddl_revoke_role.md b/docs/content/preview/api/ycql/ddl_revoke_role.md
@@ -5,7 +5,7 @@ linkTitle: REVOKE ROLE
 description: Use the `REVOKE ROLE` statement to revoke a role (which represents a group of permissions and the SUPERUSER status) from another role.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1284
 aliases:
   - /preview/api/cassandra/ddl_revoke_role

diff --git a/docs/content/preview/api/ycql/ddl_use.md b/docs/content/preview/api/ycql/ddl_use.md
@@ -5,7 +5,7 @@ linkTitle: USE
 description: Use the USE statement to specify a default keyspace for the current client session.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1290
 aliases:
   - /preview/api/cassandra/ddl_use

diff --git a/docs/content/preview/api/ycql/dml_delete.md b/docs/content/preview/api/ycql/dml_delete.md
@@ -5,7 +5,7 @@ linkTitle: DELETE
 description: Use the DELETE statement to remove rows from a specified table that meet a given condition.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1330
 aliases:
   - /preview/api/cassandra/ddl_delete

diff --git a/docs/content/preview/api/ycql/dml_insert.md b/docs/content/preview/api/ycql/dml_insert.md
@@ -5,7 +5,7 @@ linkTitle: INSERT
 description: Use the INSERT statement to add a row to a specified table.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1300
 aliases:
   - /preview/api/cassandra/dml_insert

diff --git a/docs/content/preview/api/ycql/dml_select.md b/docs/content/preview/api/ycql/dml_select.md
@@ -5,7 +5,7 @@ linkTitle: SELECT
 description: Use the SELECT statement to retrieve (part of) rows of specified columns that meet a given condition from a table.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1310
 aliases:
   - /preview/api/cassandra/dml_select

diff --git a/docs/content/preview/api/ycql/dml_transaction.md b/docs/content/preview/api/ycql/dml_transaction.md
@@ -5,7 +5,7 @@ linkTitle: TRANSACTION
 description: Use the TRANSACTION statement block to make changes to multiple rows in one or more tables in a distributed ACID transaction.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1330
 aliases:
   - /preview/api/cassandra/dml_transaction

diff --git a/docs/content/preview/api/ycql/dml_truncate.md b/docs/content/preview/api/ycql/dml_truncate.md
@@ -5,7 +5,7 @@ linkTitle: TRUNCATE
 description: Use the TRUNCATE statement to remove all rows from a specified table.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1330
 aliases:
   - /preview/api/cassandra/dml_truncate

diff --git a/docs/content/preview/api/ycql/dml_update.md b/docs/content/preview/api/ycql/dml_update.md
@@ -5,7 +5,7 @@ linkTitle: UPDATE
 description: Use the UPDATE statement to update one or more column values for a row in table.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1320
 aliases:
   - /preview/api/cassandra/dml_update/

diff --git a/docs/content/preview/api/ycql/explain.md b/docs/content/preview/api/ycql/explain.md
@@ -5,7 +5,7 @@ linkTitle: EXPLAIN
 description: Use the EXPLAIN statement to show the execution plan for a YCQL statement.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-statements
     weight: 1320
 aliases:
   - /preview/api/ycql/explain/

diff --git a/docs/content/preview/api/ycql/expr_fcall.md b/docs/content/preview/api/ycql/expr_fcall.md
@@ -5,7 +5,7 @@ linkTitle: Function call
 description: Use a function call expression to apply the specified function to given arguments between parentheses and return the result of the computation.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-expressions
     weight: 1350
 aliases:
   - /preview/api/cassandra/expr_fcall

diff --git a/docs/content/preview/api/ycql/expr_ocall.md b/docs/content/preview/api/ycql/expr_ocall.md
@@ -5,7 +5,7 @@ linkTitle: Operators
 description: Combine multiple expressions using YCQL operators supported in YugabyteDB.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-expressions
     weight: 1360
 aliases:
   - /preview/api/cassandra/expr_ocall

diff --git a/docs/content/preview/api/ycql/expr_simple.md b/docs/content/preview/api/ycql/expr_simple.md
@@ -5,7 +5,7 @@ linkTitle: Simple expressions
 description: A simple expression can be a column, constant, or NULL.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-expressions
     weight: 1331
 aliases:
   - /preview/api/cassandra/expr_simple

diff --git a/docs/content/preview/api/ycql/expr_subscript.md b/docs/content/preview/api/ycql/expr_subscript.md
@@ -5,7 +5,7 @@ linkTitle: Subscripted expressions
 description: Use subscripted expressions to access elements in a multi-element value, such as a map collection by using the [] operator.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-expressions
     weight: 1340
 aliases:
   - /preview/api/cassandra/expr_subscript

diff --git a/docs/content/preview/api/ycql/function_datetime.md b/docs/content/preview/api/ycql/function_datetime.md
@@ -5,7 +5,7 @@ linkTitle: Date and time
 description: Use date and time functions to work on date and time data types.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-expressions
     weight: 1560
 aliases:
   - /preview/api/cassandra/function_datetime

diff --git a/docs/content/preview/api/ycql/type_blob.md b/docs/content/preview/api/ycql/type_blob.md
@@ -5,7 +5,7 @@ linkTitle: BLOB
 description: Use the BLOB data type to represent arbitrary binary data of variable length.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-datatypes
     weight: 1370
 aliases:
   - /preview/api/cassandra/type_blob

diff --git a/docs/content/preview/api/ycql/type_bool.md b/docs/content/preview/api/ycql/type_bool.md
@@ -5,7 +5,7 @@ linkTitle: BOOLEAN
 description: Use the `BOOLEAN` data type to specify values of either "true" or "false".
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-datatypes
     weight: 1380
 aliases:
   - /preview/api/cassandra/type_bool

diff --git a/docs/content/preview/api/ycql/type_collection.md b/docs/content/preview/api/ycql/type_collection.md
@@ -5,7 +5,7 @@ linkTitle: Collection
 description: Use collection data types to specify columns for data objects that can contain more than one value.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-datatypes
     weight: 1390
 aliases:
   - /preview/api/cassandra/type_collection

diff --git a/docs/content/preview/api/ycql/type_datetime.md b/docs/content/preview/api/ycql/type_datetime.md
@@ -5,7 +5,7 @@ linkTitle: DATE, TIME, and TIMESTAMP
 description: Use the date and time data types (DATE, TIME, and TIMESTAMP) to specify dates and time.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-datatypes
     weight: 1450
 aliases:
   - /preview/api/cassandra/type_datetime

diff --git a/docs/content/preview/api/ycql/type_frozen.md b/docs/content/preview/api/ycql/type_frozen.md
@@ -5,7 +5,7 @@ linkTitle: FROZEN
 description: Use the FROZEN data type to specify columns of binary strings that result from serializing collections, tuples, or user-defined types.
 menu:
   preview:
-    parent: api-cassandra
+    parent: ycql-datatypes
     weight: 1401
 aliases:
   - /preview/api/cassandra/type_frozen