You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by "Alvin Zhang (Jira)" <ji...@apache.org> on 2025/05/16 21:04:00 UTC

[jira] [Created] (CASSANDRA-20656) Create table documentation uses two nearly-identical partials for column definition

Alvin Zhang created CASSANDRA-20656:
---------------------------------------

             Summary: Create table documentation uses two nearly-identical partials for column definition
                 Key: CASSANDRA-20656
                 URL: https://issues.apache.org/jira/browse/CASSANDRA-20656
             Project: Apache Cassandra
          Issue Type: Improvement
          Components: Documentation
            Reporter: Alvin Zhang
            Assignee: Alvin Zhang


5.0 documentation shows two sections for `column_definition` (see [here|https://cassandra.apache.org/doc/5.0/cassandra/reference/cql-commands/create-table.html#column_definition])

The `[create-table.adoc|https://github.com/apache/cassandra/blob/trunk/doc/modules/cassandra/pages/reference/c ql-commands/create-table.adoc?plain=1#L56]` references two partials:
 * cassandra:partial$table-column-definitions.adoc
 * cassandra:partial$primary-key-column.adoc
which are nearly identical

```

diff doc/modules/cassandra/partials/table-column-definitions.adoc doc/modules/cassandra/partials/primary-key-column.adocĀ 
11c11
< * When `PRIMARY KEY` is at the end of a column definition, that column is the only primary key for the table, and is defined as the https://cassandra.apache.org/_/glossary.html#partition-key[partition key].
---
> * When `PRIMARY KEY` is at the end of a column definition, that column is the only primary key for the table, and is defined as the https://cassandra.apache.org/_/glossary.html#[partition-key][partition key].

```

I propose removing `primary-key-column.adoc` and its reference in `create-table.adoc`



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org