diff --git a/doc/user/content/releases/previews.md b/doc/user/content/releases/previews.md index fce5b037223ff..a8b354060bbc7 100644 --- a/doc/user/content/releases/previews.md +++ b/doc/user/content/releases/previews.md @@ -76,12 +76,6 @@ For more information, see: - [`CREATE CLUSTER`](/sql/create-cluster). - [`ALTER CLUSTER`](/sql/alter-cluster). -### COMMENT ON - -Materialize adds the `COMMENT ON` command to allow commenting on an object. - -For more information, see [`COMMENT ON`](/sql/comment-on). - ### Support for Fivetran Materialize adds support for Fivetran to sync data into Materialize. diff --git a/doc/user/content/sql/comment-on.md b/doc/user/content/sql/comment-on.md index 17c92e78a0099..1f2d2923d176c 100644 --- a/doc/user/content/sql/comment-on.md +++ b/doc/user/content/sql/comment-on.md @@ -6,8 +6,6 @@ menu: parent: 'commands' --- -{{< public-preview />}} - `COMMENT ON ...` adds or updates the comment of an object. ## Syntax diff --git a/doc/user/content/sql/system-catalog/mz_internal.md b/doc/user/content/sql/system-catalog/mz_internal.md index 12a2b29c0d813..5b19bf655bc89 100644 --- a/doc/user/content/sql/system-catalog/mz_internal.md +++ b/doc/user/content/sql/system-catalog/mz_internal.md @@ -289,14 +289,14 @@ The `mz_pending_cluster_replicas` table lists the replicas that were created dur ## `mz_comments` -The `mz_comments` table stores optional comments (descriptions) for objects in the database. +The `mz_comments` table stores optional comments (i.e., descriptions) for objects in the database. | Field | Type | Meaning | | -------------- |-------------| -------- | | `id` | [`text`] | The ID of the object. Corresponds to [`mz_objects.id`](../mz_catalog/#mz_objects). | | `object_type` | [`text`] | The type of object the comment is associated with. | -| `object_sub_id`| [`integer`] | For a comment on a column of a relation, this is the column number. For all other object types this column is `NULL`. | +| `object_sub_id`| [`integer`] | For a comment on a column of a relation, the column number. `NULL` for other object types. | | `comment` | [`text`] | The comment itself. | ## `mz_compute_dependencies`