From 079f1f5e76963e58d64fc57e261d75aa799c6c86 Mon Sep 17 00:00:00 2001
From: Dorota Wojcik <dorota.wojcik@aiven.io>
Date: Fri, 13 Oct 2023 15:22:57 +0200
Subject: [PATCH] draft for the delete page

---
 _toc.yml                                      |  2 +
 .../howto/byoc/delete-custom-cloud.rst        | 48 +++++++++++++++++++
 2 files changed, 50 insertions(+)
 create mode 100644 docs/platform/howto/byoc/delete-custom-cloud.rst

diff --git a/_toc.yml b/_toc.yml
index 7fc9183a79..ef4fe7be88 100644
--- a/_toc.yml
+++ b/_toc.yml
@@ -153,6 +153,8 @@ entries:
           title: Add customer contacts
         - file: docs/platform/howto/byoc/rename-custom-cloud
           title: Rename custom cloud
+        - file: docs/platform/howto/byoc/delete-custom-cloud
+          title: Delete custom cloud
     - file: docs/platform/concepts/enhanced-compliance-env
     - file: docs/platform/concepts/aiven-node-firewall-configuration
     - file: docs/platform/concepts/cloud-security
diff --git a/docs/platform/howto/byoc/delete-custom-cloud.rst b/docs/platform/howto/byoc/delete-custom-cloud.rst
new file mode 100644
index 0000000000..18d6685250
--- /dev/null
+++ b/docs/platform/howto/byoc/delete-custom-cloud.rst
@@ -0,0 +1,48 @@
+Delete your custom cloud
+========================
+
+.. topic:: Bring your own cloud (BYOC)
+
+    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. 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>`.
+
+This article details how to delete your custom cloud in `Aiven Console <https://console.aiven.io/>`_.
+
+About deleting custom clouds
+----------------------------
+
+Prerequisites
+-------------
+
+* Administrator's role for your Aiven organization
+* At least one :doc:`custom cloud created </docs/platform/howto/byoc/create-custom-cloud>` in your Aiven organization
+* Access to `Aiven Console <https://console.aiven.io/>`_
+
+Delete your cloud
+-----------------
+
+1. Log in to `Aiven Console <https://console.aiven.io/>`_ as an administrator.
+2. From the left sidebar, select **Bring your own cloud**.
+3. In the **Bring you own cloud** view, select one of the clouds available on the list.
+4. In the selected cloud's page, use the ellipsis (**...**) menu in the top right corner.
+
+.. topic:: Result
+
+    Your custom cloud has been deleted.
+
+Check it out
+------------
+
+You can preview the updated name of your cloud by taking the following steps:
+
+1. Log in to `Aiven Console <https://console.aiven.io/>`_ as an administrator.
+2. From the left sidebar, select **Bring your own cloud**.
+3. In the **Bring you own cloud** view, see the list of the available clouds.
+
+Related reading
+---------------
+
+* :doc:`Bring your own cloud </docs/platform/concepts/byoc>`
+* :doc:`Enable bring your own cloud (BYOC) </docs/platform/howto/byoc/enable-byoc>`
+* :doc:`Create a custom cloud in Aiven </docs/platform/howto/byoc/create-custom-cloud>`
+* :doc:`Assign a project to your custom cloud </docs/platform/howto/byoc/assign-project-custom-cloud>`
+* :doc:`Add customer's contact information for your custom cloud </docs/platform/howto/byoc/add-customer-info-custom-cloud>`