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?\[email protected]: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:[email protected][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:[email protected][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:[email protected][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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
