[CASSANDRA-15715] [CQL help] URL for help topic CREATE_KEYSPACE is leading to page that does not exist

• Type: Bug
• Status: Triage Needed
• Priority: Normal
• Resolution: Unresolved
• Component/s: Documentation/Blog
• Platform: All
• Assignee: Dean Z
• Reporter: Andrey Andreev

Authors

Dean Z

• Created: 11/Apr/20 19:18
• Updated: 08/Jun/20 07:35

Description

URL for help topic CREATE_KEYSPACE is leading to page that does not exist

cqlsh> SHOW VERSION;
[cqlsh 5.0.1 | Cassandra 3.11.6 | CQL spec 3.4.4 | Native protocol v4]
cqlsh> HELP CREATE_KEYSPACE;
*** No browser to display CQL help. URL for help topic CREATE_KEYSPACE : https://cassandra.apache.org/doc/cql3/CQL-3.2.html#createKeyspaceStmt

Page "https://cassandra.apache.org/doc/cql3/CQL-3.2.html#createKeyspaceStmt" is showing 404 "Not Found". (see screenshot attachment)

How did I install C* (From the book "Cassandra The Definitive Guide, Third Edition, page 53")

docker pull cassandra
docker run --name c-seed cassandra
docker exec -it c-seed cqlsh
HELP CREATE_KEYSPACE;

 It is probably related to this part of code: https://github.com/apache/cassandra/blob/d069fd235f3553ef6e3267efc9cf3b9b2fe4e70e/bin/cqlsh.py#L76

Probably we need to replace:

CASSANDRA_CQL_HTML_FALLBACK = 'https://cassandra.apache.org/doc/cql3/CQL-3.2.html'

with

CASSANDRA_CQL_HTML_FALLBACK = 'https://cassandra.apache.org/doc/old/CQL-3.0.html'

 

Issue Links

• duplicates: CASSANDRA-13047 Point cqlsh help to the new doc
• relates to: CASSANDRA-15716 Table of content links for https://cassandra.apache.org/doc/old/CQL-3.0.html are broken