You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by "Michael Semb Wever (Jira)" <ji...@apache.org> on 2021/07/12 19:47:00 UTC
[jira] [Commented] (CASSANDRA-16761) New Cassandra Website and
Documentation
[ https://issues.apache.org/jira/browse/CASSANDRA-16761?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17379345#comment-17379345 ]
Michael Semb Wever commented on CASSANDRA-16761:
------------------------------------------------
Feedback on things still to fix:
* change antora's component name from "Project" to "_" (and fix nav links accordingly)
* remove duplicated previous adoc files (e.g. index.adoc, download-old.adoc, …)
* rename home.html to index.html
* add latest blog page
* new version 4.0-rc2 on download page
* "Learn more" button appears twice on front page
* links to /Cassandra/ need to be replaced with /doc/latest/
* the links to the Community pages don't work (from top nav)
* create a .htaccess file to map legacy URLs to new URL ( and / into /_/index.html )
* copying site-content/build/html/* into content/ (while keeping the /doc/ folder )
> New Cassandra Website and Documentation
> ---------------------------------------
>
> Key: CASSANDRA-16761
> URL: https://issues.apache.org/jira/browse/CASSANDRA-16761
> Project: Cassandra
> Issue Type: Epic
> Components: Documentation/Website
> Reporter: Anthony Grasso
> Assignee: Anthony Grasso
> Priority: High
> Fix For: 4.0.x
>
>
> This epic captures the work associated with the development of the new Cassandra website and documentation.
> Work to create the new website and documentation will be broken up as follows:
> * Proof of concept - CASSANDRA-16029
> * Website concept and design - CASSANDRA-16115
> * Develop tooling to render new website and documentation - CASSANDRA-16066
> * Create website content that will be rendered by new tooling - CASSANDRA-16762
> * Create Cassandra documentation content that will be rendered by new tooling - CASSANDRA-16763
> It is expected that the new website and documentation will be in asciidoc format and rendered using Antora.
> Antora is purpose built for rendering versioned documentation to HTML. In addition it allows rendering customisations via Java Script which may be useful when rending the website.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org