From 9b7f407db815fd7bc8ab0cda32ba18f0c16b7013 Mon Sep 17 00:00:00 2001
From: Dorota Wojcik <dorota.wojcik@aiven.io>
Date: Thu, 7 Sep 2023 16:51:03 +0200
Subject: [PATCH] post-testing fixes

---
 docs/platform/howto/byoc/create-custom-cloud.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/docs/platform/howto/byoc/create-custom-cloud.rst b/docs/platform/howto/byoc/create-custom-cloud.rst
index 4711859c7a..f670d939d2 100644
--- a/docs/platform/howto/byoc/create-custom-cloud.rst
+++ b/docs/platform/howto/byoc/create-custom-cloud.rst
@@ -1,13 +1,13 @@
 Create a custom cloud in Aiven
 ==============================
 
-A custom cloud is your own cloud infrastructure integrated with your Aiven organization. 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.
+A :doc:`custom cloud </docs/platform/concepts/byoc>` is your own cloud infrastructure integrated with your Aiven organization. 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.
 
 .. important::
 
     Creating custom clouds in your Aiven organization requires enabling :doc:`the bring your own cloud (BYOC) feature </docs/platform/concepts/byoc>`, which is a :doc:`limited availability feature </docs/platform/concepts/beta_services>`. If you're interested in trying it out, contact the sales team at `sales@Aiven.io <mailto:sales@Aiven.io>`_.
 
-Learn how to add a :doc:`custom cloud </docs/platform/concepts/byoc>` to your Aiven organization, and check out how it works.
+This article provides you with instructions on how to :ref:`add a custom cloud <create-cloud>` to your Aiven organization.
 
 About creating a custom cloud
 -----------------------------
@@ -30,7 +30,9 @@ Prerequisites
 * AWS account
 * BYOC feature enabled for your Aiven organization by the sales team (`sales@Aiven.io <mailto:sales@Aiven.io>`_)
 * Access to `Aiven Console <https://console.aiven.io/>`_
-* Terraform
+* Terraform installed
+
+.. _create-cloud:
 
 Create a custom cloud
 ---------------------
@@ -93,6 +95,10 @@ Role ARN is an `identifier of the role <https://docs.aws.amazon.com/IAM/latest/U
 
 Use the Terraform template generated in step :ref:`Generate an infrastructure template <generate-infra-template>` to create your Role ARN by deploying the template in your AWS account.
 
+.. important::
+
+   When running ``terraform plan`` and ``terraform apply``, make sure you add ``-var-file=FILE_NAME.vars`` as an option.
+
 As soon as you acquire Role ARN, enter it into the **Role ARN** field in the **Create custom cloud** workflow, and select **Next** to proceed.
 
 .. note::