From a4d20de876ee8f984607abaa9775663a39c29cea Mon Sep 17 00:00:00 2001
From: JakeSCahill <jake@redpanda.com>
Date: Thu, 22 Oct 2026 15:19:07 +0100
Subject: [PATCH 1/2] operator: link cloud_storage_* field docs to the object
 storage page

The cloud_storage_* field comments in RedpandaClusterSpec.config link to
the cluster and tunable properties pages with anchors that only exist on
the object storage properties page, so the CRD reference and kubectl
explain send readers to a page without the property. Point the 29 links
at the page that documents them. Link-only change; the CRD manifest and
the crd-docs testdata are regenerated.

cloud_storage_reconciliation_interval_ms is left alone: the property is
deprecated and has no heading on any docs page.
---
 .../operator-Fixed-20261022-153000.yaml       |   7 ++
 .../v1alpha2/redpanda_clusterspec_types.go    |  58 ++++-----
 .../redpanda/v1alpha2/testdata/crd-docs.adoc  |  58 ++++-----
 .../bases/cluster.redpanda.com_redpandas.yaml | 116 +++++++++---------
 4 files changed, 123 insertions(+), 116 deletions(-)
 create mode 100644 .changes/unreleased/operator-Fixed-20261022-153000.yaml

diff --git a/.changes/unreleased/operator-Fixed-20261022-153000.yaml b/.changes/unreleased/operator-Fixed-20261022-153000.yaml
new file mode 100644
index 000000000..b6d314d94
--- /dev/null
+++ b/.changes/unreleased/operator-Fixed-20261022-153000.yaml
@@ -0,0 +1,7 @@
+project: operator
+kind: Fixed
+body: |-
+    The `cloud_storage_*` field descriptions in `RedpandaClusterSpec.config` link to the Object Storage Properties page, where those properties are documented
+
+      They linked to the cluster and tunable properties pages with anchors that do not exist there, so the CRD reference and `kubectl explain` sent readers to a page without the property. Link-only change: no field, schema or default changes.
+time: 2026-10-22T15:30:00.000000+01:00
diff --git a/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go b/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go
index e85e6fbe8..b7e3669e6 100644
--- a/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go
+++ b/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go
@@ -660,67 +660,67 @@ type Tiered struct {
 
 // TieredConfig configures Tiered Storage, which requires an Enterprise license configured in `enterprise.licenseKey` or `enterprise.licenseSecretRef`.TieredConfig is a top-level field of the Helm values.
 type TieredConfig struct {
-	// Enables Tiered Storage, if a license key is provided. See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_enabled.
+	// Enables Tiered Storage, if a license key is provided. See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enabled.
 	CloudStorageEnabled *apiutil.JSONBoolean `json:"cloud_storage_enabled,omitempty"`
-	// See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_api_endpoint.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint.
 	CloudStorageAPIEndpoint *string `json:"cloud_storage_api_endpoint,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_api_endpoint_port.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint_port.
 	CloudStorageAPIEndpointPort *int `json:"cloud_storage_api_endpoint_port,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_bucket.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_bucket.
 	CloudStorageBucket *string `json:"cloud_storage_bucket,omitempty"`
-	// See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_container.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_container.
 	CloudStorageAzureContainer *string `json:"cloud_storage_azure_container,omitempty"`
-	// See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_managed_identity_id.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_managed_identity_id.
 	CloudStorageAzureManagedIdentityID *string `json:"cloud_storage_azure_managed_identity_id,omitempty"`
-	// See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_storage_account.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_storage_account.
 	CloudStorageAzureStorageAccount *string `json:"cloud_storage_azure_storage_account,omitempty"`
-	// See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_shared_key.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_shared_key.
 	CloudStorageAzureSharedKey *string `json:"cloud_storage_azure_shared_key,omitempty"`
-	// See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_endpoint.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_endpoint.
 	CloudStorageAzureADLSEndpoint *string `json:"cloud_storage_azure_adls_endpoint,omitempty"`
-	// See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_port.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_port.
 	CloudStorageAzureADLSPort *int `json:"cloud_storage_azure_adls_port,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_cache_check_interval.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_check_interval.
 	CloudStorageCacheCheckInterval *int `json:"cloud_storage_cache_check_interval,omitempty"`
 	// See https://docs.redpanda.com/current/reference/node-properties/#cloud_storage_cache_directory.
 	CloudStorageCacheDirectory *string `json:"cloud_storage_cache_directory,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_cache_size.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_size.
 	CloudStorageCacheSize *string `json:"cloud_storage_cache_size,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_credentials_source.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_credentials_source.
 	CloudStorageCredentialsSource *string `json:"cloud_storage_credentials_source,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_disable_tls.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_disable_tls.
 	CloudStorageDisableTLS *bool `json:"cloud_storage_disable_tls,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_read.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_read.
 	CloudStorageEnableRemoteRead *bool `json:"cloud_storage_enable_remote_read,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_write.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_write.
 	CloudStorageEnableRemoteWrite *bool `json:"cloud_storage_enable_remote_write,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_initial_backoff_ms.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_initial_backoff_ms.
 	CloudStorageInitialBackoffMs *int `json:"cloud_storage_initial_backoff_ms,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_manifest_upload_timeout_ms.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_manifest_upload_timeout_ms.
 	CloudStorageManifestUploadTimeoutMs *int `json:"cloud_storage_manifest_upload_timeout_ms,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_max_connection_idle_time_ms.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connection_idle_time_ms.
 	CloudStorageMaxConnectionIdleTimeMs *int `json:"cloud_storage_max_connection_idle_time_ms,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_max_connections.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connections.
 	CloudStorageMaxConnections *int `json:"cloud_storage_max_connections,omitempty"`
 	// Deprecated: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_reconciliation_interval_ms.
 	CloudStorageReconciliationIntervalMs *int `json:"cloud_storage_reconciliation_interval_ms,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_region.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_region.
 	CloudStorageRegion *string `json:"cloud_storage_region,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_max_upload_interval_sec.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_max_upload_interval_sec.
 	CloudStorageSegmentMaxUploadIntervalSec *int `json:"cloud_storage_segment_max_upload_interval_sec,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_upload_timeout_ms.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_upload_timeout_ms.
 	CloudStorageSegmentUploadTimeoutMs *int `json:"cloud_storage_segment_upload_timeout_ms,omitempty"`
-	// See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_trust_file.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_trust_file.
 	CloudStorageTrustFile *string `json:"cloud_storage_trust_file,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_d_coeff.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_d_coeff.
 	CloudStorageUploadCtrlDCoeff *int `json:"cloud_storage_upload_ctrl_d_coeff,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_max_shares.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_max_shares.
 	CloudStorageUploadCtrlMaxShares *int `json:"cloud_storage_upload_ctrl_max_shares,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_min_shares.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_min_shares.
 	CloudStorageUploadCtrlMinShares *int `json:"cloud_storage_upload_ctrl_min_shares,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_p_coeff.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_p_coeff.
 	CloudStorageUploadCtrlPCoeff *int `json:"cloud_storage_upload_ctrl_p_coeff,omitempty"`
-	// See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_update_interval_ms.
+	// See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_update_interval_ms.
 	CloudStorageUploadCtrlUpdateIntervalMs *int `json:"cloud_storage_upload_ctrl_update_interval_ms,omitempty"`
 }
 
diff --git a/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc b/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc
index 6d29c0761..a6ad3b485 100644
--- a/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc
+++ b/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc
@@ -5918,37 +5918,37 @@ TieredConfig configures Tiered Storage, which requires an Enterprise license con
 [cols="20a,50a,15a,15a", options="header"]
 |===
 | Field | Description | Default | Validation
-| *`cloud_storage_enabled`* __xref:{anchor_prefix}-github-com-redpanda-data-redpanda-operator-operator-api-apiutil-jsonboolean[$$JSONBoolean$$]__ | Enables Tiered Storage, if a license key is provided. See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_enabled. + |  | 
-| *`cloud_storage_api_endpoint`* __string__ | See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_api_endpoint. + |  | 
-| *`cloud_storage_api_endpoint_port`* __integer__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_api_endpoint_port. + |  | 
-| *`cloud_storage_bucket`* __string__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_bucket. + |  | 
-| *`cloud_storage_azure_container`* __string__ | See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_container. + |  | 
-| *`cloud_storage_azure_managed_identity_id`* __string__ | See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_managed_identity_id. + |  | 
-| *`cloud_storage_azure_storage_account`* __string__ | See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_storage_account. + |  | 
-| *`cloud_storage_azure_shared_key`* __string__ | See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_shared_key. + |  | 
-| *`cloud_storage_azure_adls_endpoint`* __string__ | See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_endpoint. + |  | 
-| *`cloud_storage_azure_adls_port`* __integer__ | See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_port. + |  | 
-| *`cloud_storage_cache_check_interval`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_cache_check_interval. + |  | 
+| *`cloud_storage_enabled`* __xref:{anchor_prefix}-github-com-redpanda-data-redpanda-operator-operator-api-apiutil-jsonboolean[$$JSONBoolean$$]__ | Enables Tiered Storage, if a license key is provided. See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enabled. + |  | 
+| *`cloud_storage_api_endpoint`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint. + |  | 
+| *`cloud_storage_api_endpoint_port`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint_port. + |  | 
+| *`cloud_storage_bucket`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_bucket. + |  | 
+| *`cloud_storage_azure_container`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_container. + |  | 
+| *`cloud_storage_azure_managed_identity_id`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_managed_identity_id. + |  | 
+| *`cloud_storage_azure_storage_account`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_storage_account. + |  | 
+| *`cloud_storage_azure_shared_key`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_shared_key. + |  | 
+| *`cloud_storage_azure_adls_endpoint`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_endpoint. + |  | 
+| *`cloud_storage_azure_adls_port`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_port. + |  | 
+| *`cloud_storage_cache_check_interval`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_check_interval. + |  | 
 | *`cloud_storage_cache_directory`* __string__ | See https://docs.redpanda.com/current/reference/node-properties/#cloud_storage_cache_directory. + |  | 
-| *`cloud_storage_cache_size`* __string__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_cache_size. + |  | 
-| *`cloud_storage_credentials_source`* __string__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_credentials_source. + |  | 
-| *`cloud_storage_disable_tls`* __boolean__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_disable_tls. + |  | 
-| *`cloud_storage_enable_remote_read`* __boolean__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_read. + |  | 
-| *`cloud_storage_enable_remote_write`* __boolean__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_write. + |  | 
-| *`cloud_storage_initial_backoff_ms`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_initial_backoff_ms. + |  | 
-| *`cloud_storage_manifest_upload_timeout_ms`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_manifest_upload_timeout_ms. + |  | 
-| *`cloud_storage_max_connection_idle_time_ms`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_max_connection_idle_time_ms. + |  | 
-| *`cloud_storage_max_connections`* __integer__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_max_connections. + |  | 
+| *`cloud_storage_cache_size`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_size. + |  | 
+| *`cloud_storage_credentials_source`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_credentials_source. + |  | 
+| *`cloud_storage_disable_tls`* __boolean__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_disable_tls. + |  | 
+| *`cloud_storage_enable_remote_read`* __boolean__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_read. + |  | 
+| *`cloud_storage_enable_remote_write`* __boolean__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_write. + |  | 
+| *`cloud_storage_initial_backoff_ms`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_initial_backoff_ms. + |  | 
+| *`cloud_storage_manifest_upload_timeout_ms`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_manifest_upload_timeout_ms. + |  | 
+| *`cloud_storage_max_connection_idle_time_ms`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connection_idle_time_ms. + |  | 
+| *`cloud_storage_max_connections`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connections. + |  | 
 | *`cloud_storage_reconciliation_interval_ms`* __integer__ | Deprecated: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_reconciliation_interval_ms. + |  | 
-| *`cloud_storage_region`* __string__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_region. + |  | 
-| *`cloud_storage_segment_max_upload_interval_sec`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_max_upload_interval_sec. + |  | 
-| *`cloud_storage_segment_upload_timeout_ms`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_upload_timeout_ms. + |  | 
-| *`cloud_storage_trust_file`* __string__ | See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_trust_file. + |  | 
-| *`cloud_storage_upload_ctrl_d_coeff`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_d_coeff. + |  | 
-| *`cloud_storage_upload_ctrl_max_shares`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_max_shares. + |  | 
-| *`cloud_storage_upload_ctrl_min_shares`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_min_shares. + |  | 
-| *`cloud_storage_upload_ctrl_p_coeff`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_p_coeff. + |  | 
-| *`cloud_storage_upload_ctrl_update_interval_ms`* __integer__ | See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_update_interval_ms. + |  | 
+| *`cloud_storage_region`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_region. + |  | 
+| *`cloud_storage_segment_max_upload_interval_sec`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_max_upload_interval_sec. + |  | 
+| *`cloud_storage_segment_upload_timeout_ms`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_upload_timeout_ms. + |  | 
+| *`cloud_storage_trust_file`* __string__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_trust_file. + |  | 
+| *`cloud_storage_upload_ctrl_d_coeff`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_d_coeff. + |  | 
+| *`cloud_storage_upload_ctrl_max_shares`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_max_shares. + |  | 
+| *`cloud_storage_upload_ctrl_min_shares`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_min_shares. + |  | 
+| *`cloud_storage_upload_ctrl_p_coeff`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_p_coeff. + |  | 
+| *`cloud_storage_upload_ctrl_update_interval_ms`* __integer__ | See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_update_interval_ms. + |  | 
 |===
 
 
diff --git a/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml b/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml
index 280a3f5d6..30c1a3845 100644
--- a/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml
+++ b/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml
@@ -33499,98 +33499,98 @@ spec:
                               or `enterprised.licenseSecretRef`.
                             properties:
                               cloud_storage_api_endpoint:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_api_endpoint.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint.
                                 type: string
                               cloud_storage_api_endpoint_port:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_api_endpoint_port.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint_port.
                                 type: integer
                               cloud_storage_azure_adls_endpoint:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_endpoint.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_endpoint.
                                 type: string
                               cloud_storage_azure_adls_port:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_port.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_port.
                                 type: integer
                               cloud_storage_azure_container:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_container.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_container.
                                 type: string
                               cloud_storage_azure_managed_identity_id:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_managed_identity_id.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_managed_identity_id.
                                 type: string
                               cloud_storage_azure_shared_key:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_shared_key.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_shared_key.
                                 type: string
                               cloud_storage_azure_storage_account:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_storage_account.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_storage_account.
                                 type: string
                               cloud_storage_bucket:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_bucket.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_bucket.
                                 type: string
                               cloud_storage_cache_check_interval:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_cache_check_interval.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_check_interval.
                                 type: integer
                               cloud_storage_cache_directory:
                                 description: See https://docs.redpanda.com/current/reference/node-properties/#cloud_storage_cache_directory.
                                 type: string
                               cloud_storage_cache_size:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_cache_size.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_size.
                                 type: string
                               cloud_storage_credentials_source:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_credentials_source.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_credentials_source.
                                 type: string
                               cloud_storage_disable_tls:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_disable_tls.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_disable_tls.
                                 type: boolean
                               cloud_storage_enable_remote_read:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_read.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_read.
                                 type: boolean
                               cloud_storage_enable_remote_write:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_write.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_write.
                                 type: boolean
                               cloud_storage_enabled:
                                 description: Enables Tiered Storage, if a license
-                                  key is provided. See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_enabled.
+                                  key is provided. See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enabled.
                                 x-kubernetes-preserve-unknown-fields: true
                               cloud_storage_initial_backoff_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_initial_backoff_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_initial_backoff_ms.
                                 type: integer
                               cloud_storage_manifest_upload_timeout_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_manifest_upload_timeout_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_manifest_upload_timeout_ms.
                                 type: integer
                               cloud_storage_max_connection_idle_time_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_max_connection_idle_time_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connection_idle_time_ms.
                                 type: integer
                               cloud_storage_max_connections:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_max_connections.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connections.
                                 type: integer
                               cloud_storage_reconciliation_interval_ms:
                                 description: 'Deprecated: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_reconciliation_interval_ms.'
                                 type: integer
                               cloud_storage_region:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_region.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_region.
                                 type: string
                               cloud_storage_segment_max_upload_interval_sec:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_max_upload_interval_sec.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_max_upload_interval_sec.
                                 type: integer
                               cloud_storage_segment_upload_timeout_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_upload_timeout_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_upload_timeout_ms.
                                 type: integer
                               cloud_storage_trust_file:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_trust_file.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_trust_file.
                                 type: string
                               cloud_storage_upload_ctrl_d_coeff:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_d_coeff.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_d_coeff.
                                 type: integer
                               cloud_storage_upload_ctrl_max_shares:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_max_shares.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_max_shares.
                                 type: integer
                               cloud_storage_upload_ctrl_min_shares:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_min_shares.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_min_shares.
                                 type: integer
                               cloud_storage_upload_ctrl_p_coeff:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_p_coeff.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_p_coeff.
                                 type: integer
                               cloud_storage_upload_ctrl_update_interval_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_update_interval_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_update_interval_ms.
                                 type: integer
                             type: object
                           credentialsSecretRef:
@@ -67677,98 +67677,98 @@ spec:
                               or `enterprised.licenseSecretRef`.
                             properties:
                               cloud_storage_api_endpoint:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_api_endpoint.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint.
                                 type: string
                               cloud_storage_api_endpoint_port:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_api_endpoint_port.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_api_endpoint_port.
                                 type: integer
                               cloud_storage_azure_adls_endpoint:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_endpoint.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_endpoint.
                                 type: string
                               cloud_storage_azure_adls_port:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_adls_port.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_adls_port.
                                 type: integer
                               cloud_storage_azure_container:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_container.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_container.
                                 type: string
                               cloud_storage_azure_managed_identity_id:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_managed_identity_id.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_managed_identity_id.
                                 type: string
                               cloud_storage_azure_shared_key:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_shared_key.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_shared_key.
                                 type: string
                               cloud_storage_azure_storage_account:
-                                description: See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_azure_storage_account.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_azure_storage_account.
                                 type: string
                               cloud_storage_bucket:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_bucket.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_bucket.
                                 type: string
                               cloud_storage_cache_check_interval:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_cache_check_interval.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_check_interval.
                                 type: integer
                               cloud_storage_cache_directory:
                                 description: See https://docs.redpanda.com/current/reference/node-properties/#cloud_storage_cache_directory.
                                 type: string
                               cloud_storage_cache_size:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_cache_size.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_cache_size.
                                 type: string
                               cloud_storage_credentials_source:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_credentials_source.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_credentials_source.
                                 type: string
                               cloud_storage_disable_tls:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_disable_tls.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_disable_tls.
                                 type: boolean
                               cloud_storage_enable_remote_read:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_read.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_read.
                                 type: boolean
                               cloud_storage_enable_remote_write:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_enable_remote_write.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enable_remote_write.
                                 type: boolean
                               cloud_storage_enabled:
                                 description: Enables Tiered Storage, if a license
-                                  key is provided. See https://docs.redpanda.com/docs/reference/cluster-properties/#cloud_storage_enabled.
+                                  key is provided. See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_enabled.
                                 x-kubernetes-preserve-unknown-fields: true
                               cloud_storage_initial_backoff_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_initial_backoff_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_initial_backoff_ms.
                                 type: integer
                               cloud_storage_manifest_upload_timeout_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_manifest_upload_timeout_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_manifest_upload_timeout_ms.
                                 type: integer
                               cloud_storage_max_connection_idle_time_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_max_connection_idle_time_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connection_idle_time_ms.
                                 type: integer
                               cloud_storage_max_connections:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_max_connections.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_max_connections.
                                 type: integer
                               cloud_storage_reconciliation_interval_ms:
                                 description: 'Deprecated: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_reconciliation_interval_ms.'
                                 type: integer
                               cloud_storage_region:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_region.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_region.
                                 type: string
                               cloud_storage_segment_max_upload_interval_sec:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_max_upload_interval_sec.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_max_upload_interval_sec.
                                 type: integer
                               cloud_storage_segment_upload_timeout_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_segment_upload_timeout_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_upload_timeout_ms.
                                 type: integer
                               cloud_storage_trust_file:
-                                description: See https://docs.redpanda.com/current/reference/cluster-properties/#cloud_storage_trust_file.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_trust_file.
                                 type: string
                               cloud_storage_upload_ctrl_d_coeff:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_d_coeff.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_d_coeff.
                                 type: integer
                               cloud_storage_upload_ctrl_max_shares:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_max_shares.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_max_shares.
                                 type: integer
                               cloud_storage_upload_ctrl_min_shares:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_min_shares.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_min_shares.
                                 type: integer
                               cloud_storage_upload_ctrl_p_coeff:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_p_coeff.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_p_coeff.
                                 type: integer
                               cloud_storage_upload_ctrl_update_interval_ms:
-                                description: See https://docs.redpanda.com/current/reference/tunable-properties/#cloud_storage_upload_ctrl_update_interval_ms.
+                                description: See https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_upload_ctrl_update_interval_ms.
                                 type: integer
                             type: object
                           credentialsSecretRef:

From 17f28cfa7c468c878e66f42b4c98e1aa946f93aa Mon Sep 17 00:00:00 2001
From: Jake Cahill <jake@redpanda.com>
Date: Thu, 22 Oct 2026 18:33:30 +0100
Subject: [PATCH 2/2] operator: link the cores field to the architecture page's
 tpc anchor

The thread-per-core section's anchor is tpc, not thread-per-core-model, so
the link landed at the top of the page and the docs link converter leaves
it as a raw URL. Comment-only change; the CRD bases and the crd-docs test
fixture carry the same text.
---
 operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go  | 2 +-
 operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc         | 2 +-
 .../crd/bases/cluster.redpanda.com_redpandabrokerpools.yaml   | 2 +-
 operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml | 4 ++--
 .../crd/bases/cluster.redpanda.com_stretchclusters.yaml       | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go b/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go
index b7e3669e6..a2561f5a6 100644
--- a/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go
+++ b/operator/api/redpanda/v1alpha2/redpanda_clusterspec_types.go
@@ -1156,7 +1156,7 @@ type RPControllers struct {
 
 // CPU configures CPU resources for containers. See https://docs.redpanda.com/current/manage/kubernetes/manage-resources/.
 type CPU struct {
-	// Specifies the number of CPU cores available to the application. Redpanda makes use of a thread per core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#thread-per-core-model. For this reason, Redpanda should only be given full cores. Note: You can increase cores, but decreasing cores is not currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350. This setting is equivalent to `--smp`, `resources.requests.cpu`, and `resources.limits.cpu`. For production, use `4` or greater.
+	// Specifies the number of CPU cores available to the application. Redpanda makes use of a thread per core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#tpc. For this reason, Redpanda should only be given full cores. Note: You can increase cores, but decreasing cores is not currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350. This setting is equivalent to `--smp`, `resources.requests.cpu`, and `resources.limits.cpu`. For production, use `4` or greater.
 	Cores *resource.Quantity `json:"cores,omitempty"`
 	// Specifies whether Redpanda assumes it has all of the provisioned CPU. This should be `true` unless the container has CPU affinity. Equivalent to: `--idle-poll-time-us 0`, `--thread-affinity 0`, and `--poll-aio 0`. If the value of full cores in `resources.cpu.cores` is less than `1`, this setting is set to `true`.
 	Overprovisioned *bool `json:"overprovisioned,omitempty"`
diff --git a/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc b/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc
index a6ad3b485..4034204b6 100644
--- a/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc
+++ b/operator/api/redpanda/v1alpha2/testdata/crd-docs.adoc
@@ -520,7 +520,7 @@ CPU configures CPU resources for containers. See https://docs.redpanda.com/curre
 [cols="20a,50a,15a,15a", options="header"]
 |===
 | Field | Description | Default | Validation
-| *`cores`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#quantity-resource-api[$$Quantity$$]__ | Specifies the number of CPU cores available to the application. Redpanda makes use of a thread per core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#thread-per-core-model. For this reason, Redpanda should only be given full cores. Note: You can increase cores, but decreasing cores is not currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350. This setting is equivalent to `--smp`, `resources.requests.cpu`, and `resources.limits.cpu`. For production, use `4` or greater. + |  | 
+| *`cores`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#quantity-resource-api[$$Quantity$$]__ | Specifies the number of CPU cores available to the application. Redpanda makes use of a thread per core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#tpc. For this reason, Redpanda should only be given full cores. Note: You can increase cores, but decreasing cores is not currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350. This setting is equivalent to `--smp`, `resources.requests.cpu`, and `resources.limits.cpu`. For production, use `4` or greater. + |  | 
 | *`overprovisioned`* __boolean__ | Specifies whether Redpanda assumes it has all of the provisioned CPU. This should be `true` unless the container has CPU affinity. Equivalent to: `--idle-poll-time-us 0`, `--thread-affinity 0`, and `--poll-aio 0`. If the value of full cores in `resources.cpu.cores` is less than `1`, this setting is set to `true`. + |  | 
 |===
 
diff --git a/operator/config/crd/bases/cluster.redpanda.com_redpandabrokerpools.yaml b/operator/config/crd/bases/cluster.redpanda.com_redpandabrokerpools.yaml
index 611e10b6a..b22c00a27 100644
--- a/operator/config/crd/bases/cluster.redpanda.com_redpandabrokerpools.yaml
+++ b/operator/config/crd/bases/cluster.redpanda.com_redpandabrokerpools.yaml
@@ -9633,7 +9633,7 @@ spec:
                         - type: string
                         description: 'Specifies the number of CPU cores available
                           to the application. Redpanda makes use of a thread per core
-                          model. For details, see https://docs.redpanda.com/current/get-started/architecture/#thread-per-core-model.
+                          model. For details, see https://docs.redpanda.com/current/get-started/architecture/#tpc.
                           For this reason, Redpanda should only be given full cores.
                           Note: You can increase cores, but decreasing cores is not
                           currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350.
diff --git a/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml b/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml
index 30c1a3845..6db3ee48e 100644
--- a/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml
+++ b/operator/config/crd/bases/cluster.redpanda.com_redpandas.yaml
@@ -22666,7 +22666,7 @@ spec:
                             - type: string
                             description: 'Specifies the number of CPU cores available
                               to the application. Redpanda makes use of a thread per
-                              core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#thread-per-core-model.
+                              core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#tpc.
                               For this reason, Redpanda should only be given full
                               cores. Note: You can increase cores, but decreasing
                               cores is not currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350.
@@ -56844,7 +56844,7 @@ spec:
                             - type: string
                             description: 'Specifies the number of CPU cores available
                               to the application. Redpanda makes use of a thread per
-                              core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#thread-per-core-model.
+                              core model. For details, see https://docs.redpanda.com/current/get-started/architecture/#tpc.
                               For this reason, Redpanda should only be given full
                               cores. Note: You can increase cores, but decreasing
                               cores is not currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350.
diff --git a/operator/config/crd/bases/cluster.redpanda.com_stretchclusters.yaml b/operator/config/crd/bases/cluster.redpanda.com_stretchclusters.yaml
index d80718534..2af4f4f11 100644
--- a/operator/config/crd/bases/cluster.redpanda.com_stretchclusters.yaml
+++ b/operator/config/crd/bases/cluster.redpanda.com_stretchclusters.yaml
@@ -450,7 +450,7 @@ spec:
                         - type: string
                         description: 'Specifies the number of CPU cores available
                           to the application. Redpanda makes use of a thread per core
-                          model. For details, see https://docs.redpanda.com/current/get-started/architecture/#thread-per-core-model.
+                          model. For details, see https://docs.redpanda.com/current/get-started/architecture/#tpc.
                           For this reason, Redpanda should only be given full cores.
                           Note: You can increase cores, but decreasing cores is not
                           currently supported. See the GitHub issue:https://github.com/redpanda-data/redpanda/issues/350.