Skip to content

Commit cb0230a

Browse files
JakeSCahillclaude
andcommitted
Apply docs team style guide fixes
Style guide compliance improvements: - Fix passive voice in opening paragraph ("This topic describes" -> direct) - Replace weak verb "uses" with "includes" in component list - Make list items parallel (all noun phrases describing components) - Add cert-manager link in prerequisites section - Remove future tense ("You'll use" -> "Use") - Refine learning objectives to be more specific to procedures - Move conditional phrase to sentence beginning for clarity Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 91d4ba6 commit cb0230a

1 file changed

Lines changed: 10 additions & 10 deletions

File tree

modules/deploy/pages/redpanda/kubernetes/k-stretch-clusters.adoc

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,11 @@
66
:page-toclevels: 1
77
:page-topic-type: how-to
88
:personas: platform_operator, platform_engineer
9-
:learning-objective-1: Deploy a Redpanda Stretch Cluster across multiple Kubernetes clusters
10-
:learning-objective-2: Configure cross-cluster networking for broker communication
11-
:learning-objective-3: Troubleshoot multicluster operator connectivity issues
9+
:learning-objective-1: Install multicluster operators with TLS certificates and peer configuration
10+
:learning-objective-2: Deploy StretchCluster and NodePool resources across Kubernetes clusters
11+
:learning-objective-3: Diagnose and resolve operator connectivity issues
1212

13-
This topic describes how to deploy a Redpanda Stretch Cluster, a single logical cluster distributed across multiple Kubernetes clusters. Stretch Clusters provide high availability across regions with low-latency local access, automatic failover through Raft consensus, and unified cluster management.
13+
Deploy a Redpanda Stretch Cluster, a single logical cluster distributed across multiple Kubernetes clusters. Stretch Clusters provide high availability across regions with low-latency local access, automatic failover through Raft consensus, and unified cluster management.
1414

1515
This beta version is available for testing and feedback. It is not supported by Redpanda and should not be used in production environments. To give feedback on beta releases, reach out to the Redpanda team in https://redpanda.com/slack[Redpanda Community Slack^].
1616

@@ -22,10 +22,10 @@ After reading this page, you will be able to:
2222
2323
CAUTION: **Clusters deployed using beta versions of the operator cannot be upgraded to the GA version.** You must delete and redeploy your cluster when upgrading from beta to GA. The StretchCluster and NodePool custom resources use the `v1alpha2` API version, which is subject to change.
2424

25-
A Stretch Cluster deployment uses:
25+
A Stretch Cluster deployment includes:
2626

27-
* **StretchCluster resource**: Defines cluster-wide configuration including Redpanda version, API settings, and networking mode
28-
* **NodePool resources**: Define broker groups within each Kubernetes cluster with replica counts, resources, and storage
27+
* **StretchCluster resource**: Cluster-wide configuration including Redpanda version, API settings, and networking mode
28+
* **NodePool resources**: Broker groups within each Kubernetes cluster with replica counts, resources, and storage
2929
* **Multicluster operators**: Redpanda Operator instances in each Kubernetes cluster that coordinate through Raft consensus
3030
* **Cross-cluster networking**: Direct broker-to-broker communication across Kubernetes clusters for Raft replication
3131
@@ -55,7 +55,7 @@ Before deploying a Stretch Cluster, ensure you have:
5555
** Access to the Kubernetes API servers of all peer clusters
5656
** Valid kubeconfig with appropriate RBAC permissions for all clusters
5757

58-
* **cert-manager**: Installed on all clusters for TLS certificate management
58+
* **cert-manager**: https://cert-manager.io/docs/installation/[cert-manager^] installed on all clusters for TLS certificate management
5959

6060
* **TLS certificates for inter-operator communication**:
6161
** ECDSA P-256 certificates (not RSA)
@@ -226,11 +226,11 @@ This command automatically:
226226
|Certificate organization field (default: `Redpanda`)
227227
|===
228228
+
229-
When the command completes, it prints a `multicluster.peers` block showing the peer addresses. You'll use these addresses in the Helm installation.
229+
When the command completes, it prints a `multicluster.peers` block showing the peer addresses. Use these addresses in the Helm installation.
230230

231231
. Install the StretchCluster and NodePool CRDs on all clusters.
232232
+
233-
The StretchCluster and NodePool CRDs are installed by the Helm chart when you set `crds.experimental=true`. If you need to install them separately (for example, in GitOps workflows), you can apply them manually:
233+
The StretchCluster and NodePool CRDs are installed by the Helm chart when you set `crds.experimental=true`. For GitOps workflows or manual installation, apply the CRDs separately:
234234
+
235235
[,bash,subs="attributes+"]
236236
----

0 commit comments

Comments
 (0)