[CASSANDRA-16727] LICENSE Text addition to Layout.html breaks Cassandra Website rendering

• Type: Bug
• Status: Resolved
• Priority: Normal
• Resolution: Fixed
• Fix Version/s: 3.11.11, 4.0.1, 4.1-alpha1, 4.1
• Component/s: Documentation/Website
• Labels: pull-request-available
• Bug Category: Correctness
• Severity: Low
• Complexity: Normal
• Discovered By: User Report
• Platform: All
• Since Version: 4.0-rc1

Source Control Link

https://github.com/apache/cassandra/commit/b3cdc131ab53fe9affd6115ac9e3aaf495ea8530

Test and Documentation Plan

Manual testing of Cassandra branch and website on desktop using Jekyll

• Assignee: Brian Houser
• Reporter: Brian Houser

Authors

Brian Houser

Reviewers

Michael Semb Wever

• Created: 09/Jun/21 17:47
• Updated: 27/May/22 19:25
• Resolved: 25/Jun/21 11:20

Description

The newest docs contain a license agreement comment found in the layout.html of the theme.  This occurs before front matter indicator...
https://github.com/apache/cassandra/blob/cassandra-3.11/doc/source/_theme/cassandra_theme/layout.html

Jekyll assumes that the front matter while be at the top "—".  This causes Jekyll to break when serving the page on the website.

There are a few other docs that seem to have this problem, and serving the latest docs of the website breaks the rendering.

Issue Links

• is caused by: CASSANDRA-16633 Only include versioned files in rat-report
• links to: GitHub Pull Request #61