From d7bea83e5f2d17801498579249dc8011ff8b0c1a Mon Sep 17 00:00:00 2001
From: Dorota Wojcik <dorota.wojcik@aiven.io>
Date: Wed, 11 Oct 2023 17:53:24 +0200
Subject: [PATCH] fixes

---
 .../howto/byoc/create-custom-cloud.rst        | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/docs/platform/howto/byoc/create-custom-cloud.rst b/docs/platform/howto/byoc/create-custom-cloud.rst
index 1b99e0e315..423898a446 100644
--- a/docs/platform/howto/byoc/create-custom-cloud.rst
+++ b/docs/platform/howto/byoc/create-custom-cloud.rst
@@ -12,6 +12,9 @@ This article provides you with instructions on how to enable BYOC and :ref:`add
 About creating a custom cloud
 -----------------------------
 
+How it works
+~~~~~~~~~~~~
+
 .. important::
 
    Before getting down to enabling BYOC and, next, creating a custom cloud, make sure you understand all the :ref:`limitations <byoc-limitations>` and meet all the :ref:`prerequisites <byoc-prerequisites>`.
@@ -29,7 +32,7 @@ To be able to create custom clouds on the Aiven platform, first you need to enab
 .. _byoc-limitations:
 
 Limitations
-'''''''''''
+~~~~~~~~~~~
 
 * You need at least the Priority tier of Aiven support services to be eligible for activating BYOC.
 * If you want to build your custom cloud with a cloud provider other than AWS, you cannot use `Aiven Console <https://console.aiven.io/>`_ for this purpose. Aiven creates your custom cloud for you in that case.
@@ -39,7 +42,7 @@ Limitations
 .. _byoc-prerequisites:
 
 Prerequisites
--------------
+~~~~~~~~~~~~~
 
 * Access to `Aiven Console <https://console.aiven.io/>`_
 * Administrator's role for your Aiven organization
@@ -65,8 +68,16 @@ Creating custom clouds requires enabling the BYOC feature first.
 
 .. _create-cloud:
 
-Create a custom cloud (AWS only)
---------------------------------
+Create a custom cloud
+---------------------
+
+Create a custom cloud with GCP or Azure
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to use the GCP or Azure cloud providers, you have your custom cloud created by Aiven. You cannot use `Aiven Console <https://console.aiven.io/>`_ for this purpose.
+
+Create a custom cloud with AWS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Create your infrastructure template in `Aiven Console <https://console.aiven.io/>`_, deploy the template in your AWS account to generate Role ARN, and get back to `Aiven Console <https://console.aiven.io/>`_ with your Role ARN to proceed with your custom cloud configuration. Finalize the setup by selecting in which projects you want to use your custom cloud and assigning a contact person for your custom cloud.