Juho's comments

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

@@ -46,7 +46,7 @@ Enable projects to use your custom cloud
 
    .. note::
 
-      By selecting an organization unit, you make your custom cloud available from all the projects in this unit.
+      By selecting an organizational unit, you make your custom cloud available from all the projects in this unit.
 
    * Select **Assign projects** to enable your custom cloud in specific organizational units and/ or projects. In the **Assign projects** window, use the available dropdown menus to select desired units and/ or projects as needed. Confirm your choice by selecting **Assign projects**.
 
@@ -57,7 +57,7 @@ Enable projects to use your custom cloud
 Check it out
 ------------
 
-You can preview the updated list of assigned projects by taking the following steps:
+You can verify if the cloud availability changes you made are live by taking the following steps:
 
 1. Log in to `Aiven Console <https://console.aiven.io/>`_ as an administrator.
 2. Select the organization you want to use from the dropdown menu in the top right corner.

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

@@ -521,7 +521,7 @@ or
 
 .. note::
 
-   By selecting an organization unit, you make your custom cloud available from all the projects in this unit.
+   By selecting an organizational unit, you make your custom cloud available from all the projects in this unit.
 
 Add customer contacts
 '''''''''''''''''''''

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

@@ -8,9 +8,19 @@ Delete your custom cloud
 This article details how to delete your custom cloud in `Aiven Console <https://console.aiven.io/>`_.
 
 About deleting custom clouds
-============================
+----------------------------
 
-After deleting a custom cloud, the data co-hosted in this cloud will no longer be available from the Aiven platform. The deletion only impacts resources on the Aiven site (such as cloud configuration files and the bastion service) and no cloud resources on your AWS account are touched. Make sure there are no active services using your custom cloud before deleting this cloud.
+After deleting a custom cloud, the data co-hosted in this cloud will no longer be available from the Aiven platform. Before deleting your custom cloud, make sure there are no active services using this cloud.
+
+Impact on your Aiven resources
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The deletion impacts mostly resources on the Aiven site, such as cloud configuration files.
+
+Impact on your AWS account resources
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A bastion service and the corresponding EC2 instance are deleted as a consequesnce of your custom cloud's removal. As for resources created when applying the Terraform template to create the custom cloud, they are not removed after deleting your custom cloud.Unless you've removed them earlier, you're advised to do that if deleting your cloud.
 
 Prerequisites
 -------------
@@ -28,22 +38,27 @@ Delete your cloud
 3. From the top navigation bar, select **Admin**.
 4. From the left sidebar, select **Bring your own cloud**.
 5. In the **Bring your own cloud** view, select one of the clouds available on the list.
-6. In the selected cloud's page, use the ellipsis (**...**) menu in the top right corner.
+6. In the selected cloud's page, use the ellipsis (**...**) menu in the top right corner to select **Delete**.
+7. Make sure you understand the impact and, if so, confirm that you want to delete the cloud by selecing **Delete** in the **Warning** window.
 
 .. topic:: Result
 
     Your custom cloud has been deleted.
 
+.. important::
+
+    Remember to remove the resources created in your AWS account when applying the Terraform template to create the custom cloud. They are not removed automatically after deleting the cloud. Unless you've removed them earlier, use the ``terraform destroy`` comand to delete them. See the guidelines on how to use the ``destroy`` command in `Command: destroy <https://developer.hashicorp.com/terraform/cli/commands/destroy>`_.
+
 Check it out
 ------------
 
-You can preview the updated name of your cloud by taking the following steps:
+You can verify if you deleted your cloud successfully by taking the following steps:
 
 1. Log in to `Aiven Console <https://console.aiven.io/>`_ as an administrator.
 2. Select the organization you want to use from the dropdown menu in the top right corner.
 3. From the top navigation bar, select **Admin**.
 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.
+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
 ---------------