Add consolidation comments and deprecation notices

Add notes to selfhosted-intracluster values overlay files indicating
that common (non-cloud-specific) configuration is being migrated to
values.yaml over time.

Add deprecation notices to SELFHOSTED_INTRA_CLUSTER docs pointing
to the new canonical docs on the Union documentation site. Update
controlplane README.md to reference the docs site.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: mhotan

charts/controlplane/README.md

@@ -343,25 +343,13 @@ kubectl delete namespace union-cp
 
 ## Alternative Deployment Models
 
-### Self-Hosted Intra-Cluster Deployment (AWS)
+### Self-Hosted Intra-Cluster Deployment
 
-For deploying Union control plane in the **same Kubernetes cluster** as your Union dataplane, see the dedicated guide:
+For deploying Union control plane in the **same Kubernetes cluster** as your Union dataplane, see the [Self-hosted deployment guide](https://docs.union.ai/selfmanaged/deployment/selfhosted-deployment/) on the Union documentation site.
 
-**[Self-Hosted Intra-Cluster Deployment Guide (AWS)](SELFHOSTED_INTRA_CLUSTER_AWS.md)**
-
-This deployment model is ideal for:
-
-- Fully self-hosted Union deployments
-- Single-cluster architectures with co-located control plane and dataplane
-- Environments requiring simplified networking and reduced costs
-- Deployments with strict data sovereignty requirements
-
-The intra-cluster guide covers:
-
-- TLS certificate generation for intra-cluster communication
-- Single-tenant mode configuration
-- Service discovery between control plane and dataplane
-- Complete end-to-end setup for both control plane and dataplane
+Reference guides are also available in this repository:
+- [AWS](SELFHOSTED_INTRA_CLUSTER_AWS.md)
+- [GCP](SELFHOSTED_INTRA_CLUSTER_GCP.md)
 
 ---
 

charts/controlplane/SELFHOSTED_INTRA_CLUSTER_AWS.md

@@ -1,3 +1,7 @@
+> **Note**: This guide has been migrated to the Union.ai documentation site.
+> See: https://docs.union.ai/selfmanaged/deployment/selfhosted-deployment/
+> This file is kept for reference but may not be updated.
+
 # Self-Hosted Intra-Cluster Deployment Guide (AWS)
 
 This guide covers deploying Union control plane in the **same Kubernetes cluster** as your Union dataplane (co-located deployment). This is ideal for fully self-hosted Union deployments where both control plane and dataplane run in your infrastructure.

charts/controlplane/SELFHOSTED_INTRA_CLUSTER_GCP.md

@@ -1,3 +1,7 @@
+> **Note**: This guide has been migrated to the Union.ai documentation site.
+> See: https://docs.union.ai/selfmanaged/deployment/selfhosted-deployment/
+> This file is kept for reference but may not be updated.
+
 # Self-Hosted Intra-Cluster Deployment Guide (GCP)
 
 This guide covers deploying Union control plane in the **same Kubernetes cluster** as your Union dataplane (co-located deployment). This is ideal for fully self-hosted Union deployments where both control plane and dataplane run in your infrastructure.

charts/controlplane/values.aws.selfhosted-intracluster.yaml

@@ -13,6 +13,10 @@
 # - Single-tenant mode with explicit organization configuration
 # - Direct communication between control plane and dataplane services
 # - Includes all AWS-specific configuration (RDS, S3, IAM roles)
+#
+# NOTE: Common configuration that is not cloud-specific is being migrated
+# to values.yaml over time (e.g. selfServeConfig.legacyHosts). Cloud-specific
+# overrides (storage, IAM, regions) will remain in this file.
 # ============================================================================
 
 # ----------------------------------------------------------------------------

charts/controlplane/values.gcp.selfhosted-intracluster.yaml

@@ -12,6 +12,10 @@
 # - Requires TLS certificates for gRPC/HTTP2 with NGINX
 # - Single-tenant mode with explicit organization configuration
 # - Direct communication between control plane and dataplane services
+#
+# NOTE: Common configuration that is not cloud-specific is being migrated
+# to values.yaml over time (e.g. selfServeConfig.legacyHosts). Cloud-specific
+# overrides (storage, IAM, regions) will remain in this file.
 # - Includes all GCP-specific configuration (CloudSQL, GCS, GCP service accounts)
 # ============================================================================
 

charts/dataplane/SELFHOSTED_INTRA_CLUSTER_AWS.md

@@ -1,3 +1,7 @@
+> **Note**: This guide has been migrated to the Union.ai documentation site.
+> See: https://docs.union.ai/selfmanaged/deployment/selfhosted-deployment/
+> This file is kept for reference but may not be updated.
+
 # Self-Hosted Intra-Cluster Deployment Guide (AWS)
 
 This guide covers deploying Union dataplane in the **same Kubernetes cluster** as your Union control plane (co-located deployment). This is ideal for fully self-hosted Union deployments where both control plane and dataplane run in your infrastructure.

charts/dataplane/SELFHOSTED_INTRA_CLUSTER_GCP.md

@@ -1,3 +1,7 @@
+> **Note**: This guide has been migrated to the Union.ai documentation site.
+> See: https://docs.union.ai/selfmanaged/deployment/selfhosted-deployment/
+> This file is kept for reference but may not be updated.
+
 # Self-Hosted Intra-Cluster Deployment Guide (GCP)
 
 This guide covers deploying Union dataplane in the **same Kubernetes cluster** as your Union control plane (co-located deployment). This is ideal for fully self-hosted Union deployments where both control plane and dataplane run in your infrastructure.