Docs sql commands landing page (#33996)

Author: kay-kim

doc/user/config.toml

@@ -69,13 +69,6 @@ identifier = "reference"
 name = "Reference"
 weight = 80
 
-[[menu.main]]
-name = "SQL commands"
-identifier = "commands"
-parent = "reference"
-weight = 100
-
-
 #
 # Releases
 #

doc/user/content/get-started/install.md

@@ -1,6 +1,6 @@
 ---
-title: "Install self-managed Materialize"
-description: "Install self-managed Materialize."
+title: "Install Self-Managed Materialize"
+description: "Install Self-Managed Materialize."
 disable_list: true
 menu:
   main:

doc/user/content/installation/_index.md

@@ -1,6 +1,6 @@
 ---
 title: "Installation (Self-Managed)"
-description: "Installation guides for self-managed Materialize."
+description: "Installation guides for Self-Managed Materialize."
 disable_list: true
 menu:
   main:

doc/user/content/integrations/mz-debug/self-managed.md

@@ -1,6 +1,6 @@
 ---
 title: "mz-debug self-managed"
-description: Use mz-debug to debug Materialize self-managed Materialize Kubernetes environments.
+description: Use mz-debug to debug Self-Managed Materialize Kubernetes environments.
 menu:
   main:
     parent: mz-debug

doc/user/content/security/self-managed/authentication.md

@@ -11,7 +11,7 @@ menu:
 
 ## Configuring Authentication Type
 
-To configure the authentication type used by self-managed Materialize, use the
+To configure the authentication type used by Self-Managed Materialize, use the
 `spec.authenticatorKind` setting in conjunction with any specific configuration
 for the authentication method.
 
@@ -26,7 +26,7 @@ used:
 
 Password authentication requires users to log in with a password.
 
-To configure self-managed Materialize for password authentication:
+To configure Self-Managed Materialize for password authentication:
 
  Configuration | Description
 ---------------| ------------

doc/user/content/self-managed/v25.2/installation/_index.md

@@ -1,6 +1,6 @@
 ---
 title: "Installation"
-description: "Installation guides for self-managed Materialize."
+description: "Installation guides for Self-Managed Materialize."
 disable_list: true
 aliases:
   - /self-managed/installation/

doc/user/content/sql/_index.md

@@ -1,24 +1,47 @@
 ---
-title: "Reference"
-description: "A single page with every SQL command, function, type, and keyword."
+title: "SQL commands"
+description: "SQL commands reference."
 disable_list: true
+menu:
+  main:
+    identifier: "commands"
+    parent: "reference"
+    weight: 100
+
 ---
 
-[//]: # "TODO(morsapaes) Re-hash this page into something more useful, and add it as an Overview sub-menu under Reference"
+## Create/Alter/Drop Objects
+
+{{< sql-commands-table-by-label label="object" group_by="object" >}}
+
+## Create/Read/Update/Delete Data
+
+The following commands perform CRUD operations on materialized views, views,
+sources, and tables:
+
+{{< yaml-table data="sql_commands_crud" noHeader=true >}}
+
+## RBAC
+
+Commands to manage roles and privileges:
+
+{{< yaml-table data="sql_commands_rbac" noHeader=true >}}
+
+
+## Query Introspection (`Explain`)
+
+{{< yaml-list data="sql_commands_all" label="explain" numColumns="1" >}}
+
+## Object Introspection (`SHOW`) { #show }
 
-We want Materialize to be easy to use, so we designed it to work with SQL. However, every database implements SQL a little differently, and none matches the full standard. In general, we model our implementation after PostgreSQL.
+{{< yaml-list data="sql_commands_all" label="show" numColumns="3" >}}
 
-This section is a reference that details the SQL commands and features we support.
+## Session
 
-## Architecture
+Commands related with session state and configurations:
 
-- [Data types](./types)
-- [Functions + operators](./functions)
-- [Identifiers](./identifiers)
-- [Namespaces](./namespaces)
-- [System catalog](./system-catalog)
-- [Isolation level](./isolation-level)
+{{< yaml-list data="sql_commands_all" label="session" numColumns="1" >}}
 
-## Statements
+## Validations
 
-To see information about a statement, select it in the left nav bar.
+{{< yaml-list data="sql_commands_all" label="other" >}}

doc/user/content/sql/drop-user.md

@@ -6,7 +6,8 @@ menu:
     parent: commands
 ---
 
-`DROP USER` removes a role from Materialize.
+`DROP USER` removes a role from Materialize. `DROP USER` is an alias for [`DROP ROLE`](../drop-role).
+
 
 ## Syntax
 
@@ -17,10 +18,6 @@ Field | Use
 **IF EXISTS** | Do not return an error if the specified role does not exist.
 _role_name_ | The role you want to drop. For available roles, see [`mz_roles`](/sql/system-catalog/mz_catalog#mz_roles).
 
-## Details
-
-`DROP USER` is an alias for [`DROP ROLE`](../drop-role).
-
 ## Privileges
 
 The privileges required to execute this statement are: