[CASSANDRA-17699] WEBSITE - Broken link to "existing documents" in development/documentation.html

• Type: Improvement
• Status: Resolved
• Priority: Normal
• Resolution: Fixed
• Fix Version/s: NA
• Component/s: Documentation/Website
• Labels: pull-request-available
• Change Category: Semantic
• Complexity: Normal
• Platform: All

Source Control Link

https://github.com/apache/cassandra-website/commit/11349c1ad68d896c3a132354f39ac042572cffb1

Test and Documentation Plan

Build the website locally then stage it to make sure that changes + all elements of the page render correctly.

• Assignee: Matthew D. Sacks
• Reporter: Matthew D. Sacks

Authors

Matthew D. Sacks

Reviewers

Erick Ramirez, Michael Semb Wever

• Created: 17/Jun/22 15:22
• Updated: 18/Aug/22 13:14
• Resolved: 18/Aug/22 13:14

Description

The “existing documents” link throws a 404 error when clicked on from https://cassandra.apache.org/_/development/documentation.html.

Using a static site generator often requires the use of a markup language instead of visual editors (which some people would call good news). Antora processes Ascidoc, the markup language used to generate our documentation. Markup languages allow you to format text using certain syntax elements. Your document structure will also have to follow specific conventions. Feel free to take a look at existing documents to get a better idea how we structure our documents.

Can someone provide the proper destination link?

Issue Links

• links to: GitHub Pull Request #143
• links to: GitHub Pull Request #157