[CASSANDRA-14955] Website can be built without nodetool documentation by accident

• Type: Bug
• Status: Resolved
• Priority: Low
• Resolution: Fixed
• Fix Version/s: 4.0-alpha1, 4.0
• Component/s: Documentation/Website
• Severity: Low
• Assignee: Joey Lynch
• Reporter: Joey Lynch

Authors

Joey Lynch

Reviewers

Michael Semb Wever

• Created: 07/Jan/19 03:09
• Updated: 24/Sep/20 05:04
• Resolved: 07/Jan/19 07:08

Description

While [e-mail] was generating docs today we accidentally pushed empty nodetool docs because the make website target doesn't fail if nodetool fails to run. We believe that this is due to the line in gen-nodetool-docs.py which uses subprocess.call instead of check_call.

Let's make it so that if you try to build docs without nodetool being available the build should fail so that we cant make the same mistake again.

Issue Links

• is related to: CASSANDRA-16093 Cassandra website is building/including the wrong versioned nodetool docs
• is related to: CASSANDRA-16066 Create tooling and update repository layout to render new website