update rpk cloud byoc (#39)

* #2226 update rpk cloud byoc

* minor nav update

modules/ROOT/nav.adoc

@@ -8,8 +8,8 @@
 *** xref:get-started:cluster-types/serverless.adoc[Serverless]
 *** xref:get-started:cluster-types/byoc/index.adoc[BYOC]
 **** xref:get-started:cluster-types/byoc/create-byoc-cluster-aws.adoc[]
-**** xref:get-started:cluster-types/byoc/create-byoc-cluster-gcp.adoc[]
 **** xref:get-started:cluster-types/byoc/create-byoc-cluster-azure.adoc[]
+**** xref:get-started:cluster-types/byoc/create-byoc-cluster-gcp.adoc[]
 **** xref:get-started:cluster-types/byoc/vpc-byo-gcp.adoc[]
 **** xref:get-started:cluster-types/byoc/remote-read-replicas.adoc[Create a Remote Read Replica Topic]
 *** xref:get-started:cluster-types/dedicated/index.adoc[Dedicated]

modules/get-started/pages/cloud-overview.adoc

@@ -220,6 +220,8 @@ Agents also manage VPC peering networks. One agent manages each network resource
 +
 image::shared:byoc_apply.png[cloud_byoc_apply]
 
+NOTE: To create a Redpanda cluster in your virtual private cloud (VPC), follow the instructions in the Redpanda Cloud UI. The UI contains the parameters necessary to successfully run `rpk cloud byoc apply` with your cloud provider. 
+
 == Redpanda Cloud vs Self-Managed feature compatibility
 
 Redpanda Cloud deployments do not support the following functionality available in Redpanda Self-Managed deployments:

modules/get-started/pages/cluster-types/byoc/create-byoc-cluster-aws.adoc

@@ -2,12 +2,15 @@
 :description: Use the Redpanda Cloud UI to create a BYOC cluster on AWS.
 :page-aliases: cloud:create-byoc-cluster-aws.adoc, deploy:deployment-option/cloud/create-byoc-cluster-aws.adoc
 
-To create a Redpanda cluster in your virtual private cloud (VPC), log in to https://cloud.redpanda.com[Redpanda Cloud^]. 
+To create a Redpanda cluster in your virtual private cloud (VPC), follow the instructions in the Redpanda Cloud UI. The UI contains the parameters necessary to successfully run `rpk cloud byoc apply`.  
+
+See also: xref:get-started:cloud-overview.adoc#redpanda-cloud-architecture[Redpanda Cloud architecture].
 
 == Create a BYOC cluster
 
-. On the Clusters page, click *Create cluster*, then click *Create BYOC cluster*.
-. Enter a cluster name, then select the resource group, provider (AWS), xref:reference:tiers/byoc-tiers.adoc[region, availability zones, tier], and Redpanda version.
+. Log in to https://cloud.redpanda.com[Redpanda Cloud^].
+. On the Clusters page, click *Create cluster*, then click *Create BYOC cluster*. 
+. Enter a cluster name, then select the resource group, provider (AWS), xref:reference:tiers/byoc-tiers.adoc[region, tier], availability zones, and Redpanda version.
 +
 [NOTE]
 ==== 

modules/get-started/pages/cluster-types/byoc/create-byoc-cluster-azure.adoc

@@ -58,8 +58,11 @@ virtualMachines  eastus2      Standard_L8as_v3   1,2,3    NotAvailableForSubscri
 
 == Create a BYOC cluster
 
-After following the <<prerequisites,prerequisites>>, log in to https://cloud.redpanda.com[Redpanda Cloud^] to create a Redpanda cluster in your Azure Virtual Network. 
+To create a Redpanda cluster in your Azure Virtual Network, follow the <<prerequisites,prerequisites>> then follow the instructions in the Redpanda Cloud UI. The UI contains the parameters necessary to successfully run `rpk cloud byoc apply`.  
 
+See also: xref:get-started:cloud-overview.adoc#redpanda-cloud-architecture[Redpanda Cloud architecture].
+
+. Log in to https://cloud.redpanda.com[Redpanda Cloud^].
 . On the Clusters page, click *Create cluster*, then click *Create BYOC cluster*.
 . Enter a cluster name, then select the resource group, provider (Azure), xref:reference:tiers/byoc-tiers.adoc[region, tier], availability zones, and Redpanda version. 
 +
@@ -82,4 +85,4 @@ As part of agent deployment, Redpanda assigns the permissions required to run th
 
 == Next steps
 
-- xref:networking:azure-private-link.adoc[]
+xref:networking:azure-private-link.adoc[]

modules/get-started/pages/cluster-types/byoc/create-byoc-cluster-gcp.adoc

@@ -2,15 +2,18 @@
 :description: Use the Redpanda Cloud UI to create a BYOC cluster on GCP.
 :page-aliases: cloud:create-byoc-cluster-gcp.adoc, deploy:deployment-option/cloud/create-byoc-cluster-gcp
 
-To create a Redpanda cluster in your virtual private cloud (VPC), log in to https://cloud.redpanda.com[Redpanda Cloud^].
+To create a Redpanda cluster in your virtual private cloud (VPC), follow the instructions in the Redpanda Cloud UI. The UI contains the parameters necessary to successfully run `rpk cloud byoc apply`.  
 
 NOTE: With standard BYOC clusters, Redpanda manages security policies and resources for your VPC, including subnetworks, service accounts, IAM roles, firewall rules, and storage buckets. For the most security, you can manage these resources yourself with a xref:get-started:cluster-types/byoc/vpc-byo-gcp.adoc[customer-managed VPC on GCP].
 
+See also: xref:get-started:cloud-overview.adoc#redpanda-cloud-architecture[Redpanda Cloud architecture].
+
 == Create a BYOC cluster
 
+. Log in to https://cloud.redpanda.com[Redpanda Cloud^].
 . On the Clusters page, click *Create cluster*, then click *Create BYOC cluster*.
 +
-Enter a cluster name, then select the resource group, provider (GCP), xref:reference:tiers/byoc-tiers.adoc[region, availability zones, tier], and Redpanda version.
+Enter a cluster name, then select the resource group, provider (GCP), xref:reference:tiers/byoc-tiers.adoc[region, tier], availability zones, and Redpanda version.
 +
 [NOTE]
 ====
@@ -31,4 +34,4 @@ Note that `rpk` configures the permissions required by the agent to provision an
 
 == Next steps
 
-- xref:networking:byoc/gcp/index.adoc[Configure private networking]
+xref:networking:byoc/gcp/index.adoc[Configure private networking]