You are viewing a plain text version of this content. The canonical link for it is here.
Posted to pr@cassandra.apache.org by GitBox <gi...@apache.org> on 2022/01/24 07:28:49 UTC
[GitHub] [cassandra-website] ErickRamirezAU commented on a change in pull request #90: CASSANDRA-17264 - Content Update, Link fixes
ErickRamirezAU commented on a change in pull request #90:
URL: https://github.com/apache/cassandra-website/pull/90#discussion_r787344335
##########
File path: site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-4.0-Overview.adoc
##########
@@ -21,7 +21,7 @@ Testing included purpose-built new tools to cover every requirement:
* Fault injection
* Unit / dtest coverage expansion
-Those {site-url}blog/Testing-Apache-Cassandra-4.html[tools] were perfected and deployed to help meet quality goals and set a baseline for any future version of Cassandra. They provide needed infrastructure to ensure future releases retain the highest levels of quality and correctness.
+Those {site-url}_/blog/Testing-Apache-Cassandra-4.html[tools] were perfected and deployed to help meet quality goals and set a baseline for any future version of Cassandra. They provide needed infrastructure to ensure future releases retain the highest levels of quality and correctness.
Review comment:
```suggestion
Those xref:blog/Testing-Apache-Cassandra-4.html[tools] were perfected and deployed to help meet quality goals and set a baseline for any future version of Cassandra. They provide needed infrastructure to ensure future releases retain the highest levels of quality and correctness.
```
##########
File path: site-content/source/modules/ROOT/pages/development/documentation.adoc
##########
@@ -8,7 +8,7 @@
The official Cassandra documentation lives in the project's git
repository.
We use a static site generator, http://www.antora.org/[Antora], to create pages hosted at
-{site-url}/doc/latest/[cassandra.apache.org].
+{site-url}doc/latest/[cassandra.apache.org].
Review comment:
```suggestion
https://cassandra.apache.org/doc/latest/[cassandra.apache.org].
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-1-October-2020.adoc
##########
@@ -12,15 +12,15 @@ Our monthly roundup of key activities and knowledge to keep the community inform
== Release Notes
=== Released
-The most current Apache Cassandra releases are 4.0-beta2, 3.11.8, 3.0.22, 2.2.18 and 2.1.22 released on August 31 and are xref:/download.html[in the repositories]. The next cut of releases will be out soon.
+The most current Apache Cassandra releases are 4.0-beta2, 3.11.8, 3.0.22, 2.2.18 and 2.1.22 released on August 31 and are xref:download.adoc[in the repositories]. The next cut of releases will be out soon.
-Join the Cassandra xref:community.adoc#join-the-conversation[mailing list] to stay updated.
+Join the Cassandra xref:community.adoc#discussions[mailing list] to stay updated.
We continue to make progress toward the 4.0 GA release with the overarching goal of it being at a state where major users should feel confident running it in production when it is cut. Over 1,300 Jira tickets have been closed and https://issues.apache.org/jira/projects/CASSANDRA/versions/12346094[less than 100,window=_blank] remain as of this post. To gain this confidence, there are various ongoing testing efforts involving correctness, performance, and ease of use.
=== Added
-With CASSANDRA-15013, the community improved Cassandra's ability to xref:blog/improving-resiliency.adoc[handle high throughput workloads], while having enough safeguards in place to protect itself from potentially going out of memory.
+With CASSANDRA-15013, the community improved Cassandra's ability to xref:blog/Apache-Cassandra-Changelog-1-October-2020.adoc[handle high throughput workloads], while having enough safeguards in place to protect itself from potentially going out of memory.
Review comment:
Isn't this supposed to link to the "front door & backpressure" blog post?
```suggestion
With CASSANDRA-15013, the community improved Cassandra's ability to xref:blog/Improving-Apache-Cassandras-Front-Door-and-Backpressure.adoc[handle high throughput workloads], while having enough safeguards in place to protect itself from potentially going out of memory.
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Finding-Bugs-in-Cassandra's-Internals-with-Property-based-Testing.adoc
##########
@@ -1,12 +1,12 @@
-= Finding Bugs in Cassandra's Internals with Property-based Testing
+= Finding Bugs in Cassandra\s Internals with Property-based Testing
:page-layout: single-post
:page-role: blog-post
:page-post-date: October 17, 2018
:page-post-author: The Apache Cassandra Community
:description: The Apache Cassandra Community
:keywords:
-As of September 1st, the Apache Cassandra community has shifted the focus of Cassandra 4.0 development from new feature work to testing, validation, and hardening, with the goal of releasing a stable 4.0 that every Cassandra user, from small deployments to large corporations, can deploy with confidence. There are several projects and methodologies that the community is undertaking to this end. One of these is the adoption of property-based testing, which was http://cassandra.apache.org/blog/2018/08/21/testing_apache_cassandra.html[previously introduced here,window=_blank]. This post will take a look at a specific use of this approach and how it found a bug in a new feature meant to ensure data integrity between the client and Cassandra.
+As of September 1st, the Apache Cassandra community has shifted the focus of Cassandra 4.0 development from new feature work to testing, validation, and hardening, with the goal of releasing a stable 4.0 that every Cassandra user, from small deployments to large corporations, can deploy with confidence. There are several projects and methodologies that the community is undertaking to this end. One of these is the adoption of property-based testing, which was {site-url}_/blog/Testing-Apache-Cassandra-4.adoc[previously introduced here,window=_blank]. This post will take a look at a specific use of this approach and how it found a bug in a new feature meant to ensure data integrity between the client and Cassandra.
Review comment:
The link wasn't coded correctly:
```suggestion
As of September 1st, the Apache Cassandra community has shifted the focus of Cassandra 4.0 development from new feature work to testing, validation, and hardening, with the goal of releasing a stable 4.0 that every Cassandra user, from small deployments to large corporations, can deploy with confidence. There are several projects and methodologies that the community is undertaking to this end. One of these is the adoption of property-based testing, which was xref:blog/Testing-Apache-Cassandra-4.adoc[previously introduced here,window=_blank]. This post will take a look at a specific use of this approach and how it found a bug in a new feature meant to ensure data integrity between the client and Cassandra.
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Finding-Bugs-in-Cassandra's-Internals-with-Property-based-Testing.adoc
##########
@@ -1,12 +1,12 @@
-= Finding Bugs in Cassandra's Internals with Property-based Testing
+= Finding Bugs in Cassandra\s Internals with Property-based Testing
Review comment:
Is this supposed to be an "escaped apostrophe"?
```suggestion
= Finding Bugs in Cassandra\'s Internals with Property-based Testing
```
##########
File path: site-content/source/modules/ROOT/pages/quickstart.adoc
##########
@@ -165,7 +165,7 @@ Hey, that wasn’t so hard, was it?
To learn more, we suggest the following next steps:
* Read through the xref:cassandra-basics.adoc[Cassandra Basics] to learn main concepts and how Cassandra works at a high level.
-* To understand Cassandra in more detail, head over to the xref:docs[Docs].
+* To understand Cassandra in more detail, head over to the xref:Cassandra::index.adoc[Docs].
Review comment:
```suggestion
* To understand Cassandra in more detail, head over to the https://cassandra.apache.org/doc/latest/[Docs].
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-2-December-2020.adoc
##########
@@ -14,10 +14,11 @@ Our monthly roundup of key activities and knowledge to keep the community inform
Apache #Cassandra 4.0-beta3, 3.11.9, 3.0.23, and 2.2.19 were released on November 4 and are xref:download.adoc[in the repositories,window=_blank]. Please pay attention to release notes and let the community know if you encounter problems.
-Join the Cassandra xref:community.adoc#join-the-conversation[mailing list] to stay updated.
+Join the Cassandra xref:community.adoc#discussions[mailing list] to stay updated.
=== Changed
+https://lists.apache.org/list.html?\dev@cassandra.apache.org:2021-08[JKD 17, window=_blank]
Review comment:
I'm not sure what this line is for:
- the link doesn't exist
- I don't know what "JKD 17" is. Is that meant to be `JDK 17`?
In any case, I don't think this belongs here so should be removed.
```suggestion
```
##########
File path: site-content/source/modules/ROOT/pages/development/documentation.adoc
##########
@@ -86,7 +86,7 @@ _Recommended for major changes_
Significant changes to the documentation are best managed through our
Jira issue tracker. Please follow the same
-{site-url}/doc/latest/development/patches.html[contribution
+{site-url}doc/latest/development/patches.html[contribution
Review comment:
```suggestion
xref:development/patches.adoc[contribution
```
##########
File path: site-content/source/modules/ROOT/pages/development/gettingstarted.adoc
##########
@@ -24,7 +24,7 @@ Here are some suggestions for ways to contribute:
The Cassandra documentation is maintained in the Cassandra source
repository along with the Cassandra code base.
To submit changes to the documentation, follow the standard process for
-submitting a xref::patches.adoc[patch].
+submitting a xref::development/patches.adoc[patch].
Review comment:
```suggestion
submitting a xref:development/patches.adoc[patch].
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-6-April-2021.adoc
##########
@@ -33,11 +33,11 @@ The https://lists.apache.org/thread.html/r1e545f41faf6c4ac0a4c196f9ae85a142abd89
=== Added
-As the community gets closer to the launch of 4.0, we are organizing a celebration with the help of ASF – xref:blog/world_party.adoc[Cassandra World Party 4.0,window=_blank] will be a one-day, no-cost virtual event on Wednesday, April 28 to bring the global community together in celebration of the upcoming release milestone. The https://sessionize.com/cassandra[CFP for 5-minute lightning talks,window=_blank] is open now until April 9 – newcomers welcome! https://hopin.com/events/apache-cassandra-4-0-world-party[Register here,window=_blank].
+As the community gets closer to the launch of 4.0, we are organizing a celebration with the help of ASF – xref:blog/World_Party.adoc[Cassandra World Party 4.0,window=_blank] will be a one-day, no-cost virtual event on Wednesday, April 28 to bring the global community together in celebration of the upcoming release milestone. The https://sessionize.com/cassandra[CFP for 5-minute lightning talks,window=_blank] is open now until April 9 – newcomers welcome! https://hopin.com/events/apache-cassandra-4-0-world-party[Register here,window=_blank].
Review comment:
This link doesn't render correctly. I'm new to Antora so I'm asking around to figure out the correct code for this. 🙂
##########
File path: site-content/source/modules/ROOT/pages/blog/Introducing-Apache-Cassandra-4-Beta-Battle-Tested-From-Day-One.adoc
##########
@@ -8,7 +8,7 @@
This is the most *stable* Apache Cassandra in history; you should start using Apache Cassandra 4.0 Beta today in your test and QA environments, head to the xref:download.adoc[downloads site] to get your hands on it. The Cassandra community is on a mission to deliver a 4.0 GA release that is ready to be deployed to production. You can guarantee this holds true by running your application workloads against the Beta release and contributing to the community’s validation effort to get Cassandra 4.0 to GA.
-With over 1,000 bug fixes, improvements and new features and the project’s wholehearted xref:blog/testing_apache_cassandra.adoc[focus on quality] with xref:blog/finding_bugs_with_property_based_testing.adoc[replay, fuzz, property-based, fault-injection], and performance tests on clusters as large as 1,000 nodes and with hundreds of real world use cases and schemas tested, Cassandra 4.0 redefines what users should expect from any open or closed source database. With software, hardware, and QA testing donations from the likes of Instaclustr, iland, Amazon, and Datastax, this release has seen an unprecedented cross-industry collaboration towards releasing a battle-tested database with enterprise security features and an understanding of what it takes to deliver scale in the cloud.
+With over 1,000 bug fixes, improvements and new features and the project’s wholehearted xref:blog/Testing-Apache-Cassandra-4.adoc[focus on quality] with xref:blog/Finding-Bugs-in-Cassandra's-Internals-with-Property-based-Testing.adoc[replay, fuzz, property-based, fault-injection], and performance tests on clusters as large as 1,000 nodes and with hundreds of real world use cases and schemas tested, Cassandra 4.0 redefines what users should expect from any open or closed source database. With software, hardware, and QA testing donations from the likes of Instaclustr, iland, Amazon, and Datastax, this release has seen an unprecedented cross-industry collaboration towards releasing a battle-tested database with enterprise security features and an understanding of what it takes to deliver scale in the cloud.
Review comment:
Need to escape the apostrophe in the filename:
```suggestion
With over 1,000 bug fixes, improvements and new features and the project’s wholehearted xref:blog/Testing-Apache-Cassandra-4.adoc[focus on quality] with xref:blog/Finding-Bugs-in-Cassandra\'s-Internals-with-Property-based-Testing.adoc[replay, fuzz, property-based, fault-injection], and performance tests on clusters as large as 1,000 nodes and with hundreds of real world use cases and schemas tested, Cassandra 4.0 redefines what users should expect from any open or closed source database. With software, hardware, and QA testing donations from the likes of Instaclustr, iland, Amazon, and Datastax, this release has seen an unprecedented cross-industry collaboration towards releasing a battle-tested database with enterprise security features and an understanding of what it takes to deliver scale in the cloud.
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-6-April-2021.adoc
##########
@@ -33,11 +33,11 @@ The https://lists.apache.org/thread.html/r1e545f41faf6c4ac0a4c196f9ae85a142abd89
=== Added
-As the community gets closer to the launch of 4.0, we are organizing a celebration with the help of ASF – xref:blog/world_party.adoc[Cassandra World Party 4.0,window=_blank] will be a one-day, no-cost virtual event on Wednesday, April 28 to bring the global community together in celebration of the upcoming release milestone. The https://sessionize.com/cassandra[CFP for 5-minute lightning talks,window=_blank] is open now until April 9 – newcomers welcome! https://hopin.com/events/apache-cassandra-4-0-world-party[Register here,window=_blank].
+As the community gets closer to the launch of 4.0, we are organizing a celebration with the help of ASF – xref:blog/World_Party.adoc[Cassandra World Party 4.0,window=_blank] will be a one-day, no-cost virtual event on Wednesday, April 28 to bring the global community together in celebration of the upcoming release milestone. The https://sessionize.com/cassandra[CFP for 5-minute lightning talks,window=_blank] is open now until April 9 – newcomers welcome! https://hopin.com/events/apache-cassandra-4-0-world-party[Register here,window=_blank].
Review comment:
It's a typo in the filename -- needs a dash (`-`) instead of an underscore (`_`).
```suggestion
As the community gets closer to the launch of 4.0, we are organizing a celebration with the help of ASF – xref:blog/World-Party.adoc[Cassandra World Party 4.0,window=_blank] will be a one-day, no-cost virtual event on Wednesday, April 28 to bring the global community together in celebration of the upcoming release milestone. The https://sessionize.com/cassandra[CFP for 5-minute lightning talks,window=_blank] is open now until April 9 – newcomers welcome! https://hopin.com/events/apache-cassandra-4-0-world-party[Register here,window=_blank].
```
##########
File path: site-content/source/modules/ROOT/pages/development/gettingstarted.adoc
##########
@@ -65,4 +65,4 @@ coverage, as with most code bases.
Before starting work on a particular area of code, consider reviewing and
enhancing the existing test coverage.
You'll both improve your knowledge of the code before you start on an
-enhancement, and reduce the chance introducing issues with your change. See xref::testing.adoc[testing] and xref::patches.adoc[patches] for more detail.
+enhancement, and reduce the chance introducing issues with your change. See xref::development/testing.adoc[testing] and xref::development/patches.adoc[patches] for more detail.
Review comment:
```suggestion
enhancement, and reduce the chance introducing issues with your change. See xref:development/testing.adoc[testing] and xref:development/patches.adoc[patches] for more detail.
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Cassandra-and-Kubernetes-SIG-Update-and-Survey.adoc
##########
@@ -60,4 +60,4 @@ image::blog/single-region-multi-datacenter.png[Multiple Workloads / Datacenters
** Remove third DC
Although each organization is different, these scenarios or combinations of these scenarios account for 80% of most pure Apache Cassandra use cases. The SIG would love to know more about Cassandra users’ use cases for Kubernetes. Please take https://docs.google.com/forms/d/e/1FAIpQLScdoTCMxsDwRzt-U898fVmeksBlAf5fud2GVsGqC0T_IQz2Tg/viewform[this short survey,window=_blank], which will remain open through September 17, 2020.
-Join the https://cwiki.apache.org/confluence/display/CASSANDRA/Cassandra+Kubernetes+Operator+SIG[biweekly meetings,window=_blank] to stay informed.
\ No newline at end of file
+Join the https://cwiki.apache.org/confluence/display/CASSANDRA/Cassandra+Kubernetes+SIG[biweekly meetings,window=_blank] to stay informed.
Review comment:
Use the permanent link so even when the page title changes, the link will continue to work:
```suggestion
Join the https://cwiki.apache.org/confluence/x/GCzcC[biweekly meetings,window=_blank] to stay informed.
```
##########
File path: site-content/source/modules/ROOT/pages/blog/Join-Cassandra-GSoC-2021.adoc
##########
@@ -17,7 +17,7 @@ The Apache Software Foundation (ASF) has been a https://community.apache.org/gso
== How to Get Involved
==== Getting Started
-The best way to get started if you’re new to Apache Cassandra is to get acquainted by reading the {site-url}/doc/latest/[documentation,window=_blank] and setting up a local {site-url}/doc/latest/development/ide.html[development environment,window=_blank]. Play around with a locally running instance via {site-url}/doc/latest/tools/cqlsh.html?highlight=cqlsh[cqlsh,window=_blank] and {site-url}/doc/latest/tools/nodetool/nodetool.html[nodetool,window=_blank] to get a feel for how to use the database. If you run into problems or roadblocks during this exercise, don’t be shy to ask questions via the xref:community.adoc[community channels] like the developers mailto:dev-subscribe@cassandra.apache.org[mailing list] or the #cassandra-dev channel on the https://s.apache.org/slack-invite[ASF Slack,window=_blank].
+The best way to get started if you’re new to Apache Cassandra is to get acquainted by reading the {site-url}doc/latest/[documentation,window=_blank] and setting up a local {site-url}doc/latest/development/ide.html[development environment,window=_blank]. Play around with a locally running instance via {site-url}doc/latest/tools/cqlsh.html?highlight=cqlsh[cqlsh,window=_blank] and {site-url}doc/latest/tools/nodetool/nodetool.html[nodetool,window=_blank] to get a feel for how to use the database. If you run into problems or roadblocks during this exercise, don’t be shy to ask questions via the xref:community.adoc[community channels] like the developers mailto:dev-subscribe@cassandra.apache.org[mailing list] or the #cassandra-dev channel on the https://s.apache.org/slack-invite[ASF Slack,window=_blank].
Review comment:
The links with relative paths aren't working so I've had to hardcode one of them and update the others:
```suggestion
The best way to get started if you’re new to Apache Cassandra is to get acquainted by reading the https://cassandra.apache.org/doc/latest/[documentation,window=_blank] and setting up a local xref:development/ide.adoc[development environment,window=_blank]. Play around with xref:quickstart.adoc[a locally running instance using Docker,window=_blank] to get a feel for how to use the database. If you run into problems or roadblocks during this exercise, don’t be shy to ask questions via the xref:community.adoc[community channels] like the developers mailto:dev-subscribe@cassandra.apache.org[mailing list] or the #cassandra-dev channel on the https://s.apache.org/slack-invite[ASF Slack,window=_blank].
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org