fix meta descriptions

docs/platform/concepts/byoc.rst

@@ -11,12 +11,12 @@ This is where the bring your own cloud (BYOC) feature comes in enabling you to u
 Why use BYOC
 ------------
 
-There a few major reasons to utilize BYOC:
+Consider using BYOC and custom clouds if you have specific business needs or project requirements. There a few major reasons to utilize BYOC:
 
-1. **Compliance**: Aiven offers managed environments for several standard compliance regulations, such as HIPAA, PCI DSS, and GDPR. However, if you have strict regulatory requirements or special compliance requirements, BYOC may be the best option for you.
-2. **Network auditing**: If you require the visibility of all traffic within any VPC you operate in or need frequent auditing capabilities, BYOC is potentially a good fit. BYOC gives you the ability to audit network metadata but not the actual contents.
-3. **Fine-grained network control**: BYOC only requires specific network access for Aiven (for example, service management or troubleshooting) to deploy and manage open source data services, otherwise allowing you to customize your network to meet any internal requirements or requirements of your customers.
-4. **Cost optimization**: Depending on your cloud provider, with BYOC you can use cost savings plans, committed use discounts, or other strategies to save on compute and storage infrastructure costs related to Aiven services.
+* **Compliance**: Aiven offers managed environments for several standard compliance regulations, such as HIPAA, PCI DSS, and GDPR. However, if you have strict regulatory requirements or special compliance requirements, BYOC may be the best option for you.
+* **Network auditing**: If you require the visibility of all traffic within any VPC you operate in or need frequent auditing capabilities, BYOC is potentially a good fit. BYOC gives you the ability to audit network metadata but not the actual contents.
+* **Fine-grained network control**: BYOC only requires specific network access for Aiven (for example, service management or troubleshooting) to deploy and manage open source data services, otherwise allowing you to customize your network to meet any internal requirements or requirements of your customers.
+* **Cost optimization**: Depending on your cloud provider, with BYOC you can use cost savings plans, committed use discounts, or other strategies to save on compute and storage infrastructure costs related to Aiven services.
 
 .. _eligible-for-byoc:
 

docs/platform/howto/byoc/add-customer-info-custom-cloud.rst

@@ -1,14 +1,12 @@
 Add or remove customer contacts for your AWS custom cloud in Aiven
 ==================================================================
 
-A :doc:`custom cloud </docs/platform/concepts/byoc>` is a secure environment within your cloud provider account to run Aiven-managed data services. Using a custom cloud in Aiven may be the optimal solution if you have specific business needs or project requirements, such as a strict regulatory compliance. Creating and using custom clouds in your Aiven organization requires enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>`. Check the availability of the feature in :ref:`Who is eligible for BYOC <eligible-for-byoc>`. To activate BYOC in your Aiven organization, follow the steps in :doc:`Enable bring your own cloud (BYOC) with Aiven </docs/platform/howto/byoc/enable-byoc>`.
+Update the list of customer contacts for your :doc:`custom cloud </docs/platform/concepts/byoc>`.
 
 .. important::
 
     Custom cloud configuration in Aiven is an :doc:`early availability feature </docs/platform/concepts/beta_services>`. You cover the costs associated with building and maintaining your custom cloud: payments for your integrated AWS infrastructure and Aiven services within the custom cloud.
 
-This article details how to update the list of customer contacts for your custom cloud using `Aiven Console <https://console.aiven.io/>`_.
-
 About updating customer contacts
 --------------------------------
 
@@ -55,8 +53,8 @@ You can preview the updated list of contacts by taking the following steps:
 6. In the selected cloud's page, use the ellipsis (**...**) menu in the top right corner.
 7. Select **Customer contact** from the options available on the the ellipsis (**...**) menu.
 
-Related reading
----------------
+Related pages
+-------------
 
 * :doc:`Bring your own cloud </docs/platform/concepts/byoc>`
 * :doc:`Create a custom cloud in Aiven </docs/platform/howto/byoc/create-custom-cloud>`

docs/platform/howto/byoc/assign-project-custom-cloud.rst

@@ -1,14 +1,12 @@
 Enable your AWS custom cloud in Aiven organizations, units, or projects
 =======================================================================
 
-A :doc:`custom cloud </docs/platform/concepts/byoc>` is a secure environment within your cloud provider account to run Aiven-managed data services. Using a custom cloud in Aiven may be the optimal solution if you have specific business needs or project requirements, such as a strict regulatory compliance. Creating and using custom clouds in your Aiven organization requires enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>`. Check the availability of the feature in :ref:`Who is eligible for BYOC <eligible-for-byoc>`. To activate BYOC in your Aiven organization, follow the steps in :doc:`Enable bring your own cloud (BYOC) with Aiven </docs/platform/howto/byoc/enable-byoc>`.
+To be able to use a :doc:`custom cloud </docs/platform/concepts/byoc>` in your Aiven organizations, units, or projects, you need to configure its availability.
 
 .. important::
 
     Custom cloud configuration in Aiven is an :doc:`early availability feature </docs/platform/concepts/beta_services>`. You cover the costs associated with building and maintaining your custom cloud: payments for your integrated AWS infrastructure and Aiven services within the custom cloud.
 
-This article details how to allow your projects in Aiven to use your custom cloud, for example, to create services.
-
 About making custom clouds available from your projects
 -------------------------------------------------------
 
@@ -66,8 +64,8 @@ You can verify if the cloud availability changes you made are live by taking the
 5. In the **Bring your own cloud** view, select one of the clouds available on the list.
 6. In the selected cloud's page, navigate to the **Available projects** tab and check the available projects and organizational units list for the updates you made.
 
-Related reading
----------------
+Related pages
+-------------
 
 * :doc:`Bring your own cloud </docs/platform/concepts/byoc>`
 * :doc:`Enable the bring your own cloud (BYOC) feature </docs/platform/howto/byoc/enable-byoc>`

docs/platform/howto/byoc/create-custom-cloud.rst

@@ -1,16 +1,18 @@
 Create an AWS custom cloud in Aiven
 ===================================
 
-A :doc:`custom cloud </docs/platform/concepts/byoc>` is a secure environment within your cloud provider account to run Aiven-managed data services. Using a custom cloud in Aiven may be the optimal solution if you have specific business needs or project requirements, such as a strict regulatory compliance. Creating and using custom clouds in your Aiven organization requires enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>`. Check the availability of the feature in :ref:`Who is eligible for BYOC <eligible-for-byoc>`. To activate BYOC in your Aiven organization, follow the steps in :doc:`Enable bring your own cloud (BYOC) with Aiven </docs/platform/howto/byoc/enable-byoc>`.
+Create a :doc:`custom cloud </docs/platform/concepts/byoc>` in your Aiven organization to better address your specific business needs or project requirements.
+
+.. note::
+
+    * Creating and using custom clouds in your Aiven organization requires enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>`. Check the availability of the feature in :ref:`Who is eligible for BYOC <eligible-for-byoc>`. To activate BYOC in your Aiven organization, follow the steps in :doc:`Enable bring your own cloud (BYOC) with Aiven </docs/platform/howto/byoc/enable-byoc>`.
+
+    * Enabling :doc:`the BYOC feature </docs/platform/concepts/byoc>` or creating custom clouds in your Aiven environment does not affect the configuration of your existing organizations, projects, or services. This only makes the new BYOC capabilities available in your environment.
 
 .. important::
 
     Custom cloud configuration in Aiven is an :doc:`early availability feature </docs/platform/concepts/beta_services>`. You cover the costs associated with building and maintaining your custom cloud: payments for your integrated AWS infrastructure and Aiven services within the custom cloud.
 
-.. note::
-
-    Enabling :doc:`the BYOC feature </docs/platform/concepts/byoc>` or creating custom clouds in your Aiven environment does not affect the configuration of your existing organizations, projects, or services. This only makes the new BYOC capabilities available in your environment.
-
 About creating a custom cloud
 -----------------------------
 
@@ -592,8 +594,8 @@ To create a service in `Aiven Console <https://console.aiven.io/>`_ using your n
 
 When you get to the **Select service region** step while setting up your service in `Aiven Console <https://console.aiven.io/>`_, you'll be able to select **Custom clouds** from among available regions.
 
-Related reading
----------------
+Related pages
+-------------
 
 * :doc:`About bring your own cloud (BYOC) </docs/platform/concepts/byoc>`
 * :doc:`Enable bring your own cloud (BYOC) </docs/platform/howto/byoc/enable-byoc>`

docs/platform/howto/byoc/delete-custom-cloud.rst

@@ -1,14 +1,12 @@
 Delete your AWS custom cloud in Aiven
 =====================================
 
-A :doc:`custom cloud </docs/platform/concepts/byoc>` is a secure environment within your cloud provider account to run Aiven-managed data services. Using a custom cloud in Aiven may be the optimal solution if you have specific business needs or project requirements, such as a strict regulatory compliance. Creating and using custom clouds in your Aiven organization requires enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>`. Check the availability of the feature in :ref:`Who is eligible for BYOC <eligible-for-byoc>`. To activate BYOC in your Aiven organization, follow the steps in :doc:`Enable bring your own cloud (BYOC) with Aiven </docs/platform/howto/byoc/enable-byoc>`.
+Delete a :doc:`custom cloud </docs/platform/concepts/byoc>` so that it's no longer available in your Aiven organizations, units, or projects.
 
 .. important::
 
     Custom cloud configuration in Aiven is an :doc:`early availability feature </docs/platform/concepts/beta_services>`. You cover the costs associated with building and maintaining your custom cloud: payments for your integrated AWS infrastructure and Aiven services within the custom cloud.
 
-This article details how to delete your custom cloud in `Aiven Console <https://console.aiven.io/>`_.
-
 About deleting custom clouds
 ----------------------------
 
@@ -62,8 +60,8 @@ You can verify if you deleted your cloud successfully by taking the following st
 4. From the left sidebar, select **Bring your own cloud**.
 5. In the **Bring your own cloud** view, see the list of the available clouds to make sure the cloud you intended to delete is actually gone.
 
-Related reading
----------------
+Related pages
+-------------
 
 * :doc:`Bring your own cloud </docs/platform/concepts/byoc>`
 * :doc:`Enable bring your own cloud (BYOC) </docs/platform/howto/byoc/enable-byoc>`

docs/platform/howto/byoc/enable-byoc.rst

@@ -1,14 +1,13 @@
 Enable bring your own cloud (BYOC)
 ==================================
 
-Enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>` allows you to :doc:`create custom clouds </docs/platform/howto/byoc/create-custom-cloud>` in your Aiven organization. A :doc:`custom cloud </docs/platform/concepts/byoc>` is a secure environment within your cloud provider account to run Aiven-managed data services. Using a custom cloud in Aiven may be the optimal solution if you have specific business needs or project requirements, such as a strict regulatory compliance.
+Enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>` allows you to :doc:`create custom clouds </docs/platform/howto/byoc/create-custom-cloud>` in your Aiven organization. For more information on BYOC and custom clouds, check 
+:doc:`Bring your own cloud (BYOC) </docs/platform/concepts/byoc>`.
 
 .. note::
 
    Enabling :doc:`the BYOC feature </docs/platform/concepts/byoc>` or creating custom clouds in your Aiven environment does not affect the configuration of your existing Aiven organizations, projects, or services. This only allows you to run Aiven services in your cloud provider account.
 
-This article provides you with instructions on how to request enabling BYOC in your Aiven organization.
-
 About enabling BYOC
 -------------------
 
@@ -61,8 +60,8 @@ With BYOC activated in your Aiven organization, you can use custom clouds:
 * :ref:`Create them yourself using Aiven Console if the cloud provider you selected was AWS <create-cloud-aws>`
 * :ref:`Request the Aiven team to create one if the cloud provider you selected was GCP or Azure <create-cloud-non-aws>`.
 
-Related reading
----------------
+Related pages
+-------------
 
 * :doc:`Create a custom cloud </docs/platform/howto/byoc/create-custom-cloud>`
 * :doc:`About bring your own cloud (BYOC) </docs/platform/concepts/byoc>`

docs/platform/howto/byoc/rename-custom-cloud.rst

@@ -1,15 +1,12 @@
 Rename your AWS custom cloud in Aiven
 =====================================
 
-
-A :doc:`custom cloud </docs/platform/concepts/byoc>` is a secure environment within your cloud provider account to run Aiven-managed data services. Using a custom cloud in Aiven may be the optimal solution if you have specific business needs or project requirements, such as a strict regulatory compliance. Creating and using custom clouds in your Aiven organization requires enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>`. Check the availability of the feature in :ref:`Who is eligible for BYOC <eligible-for-byoc>`. To activate BYOC in your Aiven organization, follow the steps in :doc:`Enable bring your own cloud (BYOC) with Aiven </docs/platform/howto/byoc/enable-byoc>`.
+Change the name of your :doc:`custom cloud </docs/platform/concepts/byoc>`.
 
 .. important::
 
     Custom cloud configuration in Aiven is an :doc:`early availability feature </docs/platform/concepts/beta_services>`. You cover the costs associated with building and maintaining your custom cloud: payments for your integrated AWS infrastructure and Aiven services within the custom cloud.
 
-This article details how to change the name of your custom cloud in `Aiven Console <https://console.aiven.io/>`_.
-
 About renaming custom clouds
 ----------------------------
 
@@ -48,8 +45,8 @@ You can preview the updated name of your cloud by taking the following steps:
 4. From the left sidebar, select **Bring your own cloud**.
 5. In the **Bring your own cloud** view, see the list of the available clouds and identify the cloud with the name you updated.
 
-Related reading
----------------
+Related pages
+-------------
 
 * :doc:`Bring your own cloud </docs/platform/concepts/byoc>`
 * :doc:`Create a custom cloud in Aiven </docs/platform/howto/byoc/create-custom-cloud>`