Update the Flexible Environments article

umbraco-cloud/SUMMARY.md

@@ -81,7 +81,6 @@
 
 ## Deployments
 
-* [Streamline Your Deployments](deployment/streamline-your-deployments.md)
 * [Deployment](deployment/README.md)
 * [Deploying between environments](deployment/cloud-to-cloud.md)
 * [Transferring Content, Media, Members, and Forms](deployment/content-transfer.md)

umbraco-cloud/getting-started/flexible-environments.md

@@ -11,15 +11,13 @@ hidden: true
 Beta feature: Some features might not be fully available.
 {% endhint %}
 
-Flexible Environments allow users to create and manage environments outside the regular left-to-right deployment flow. This enhancement provides greater flexibility in orchestrating both code and content workflows, empowering developers and content editors to work in a way that best suits their needs.
+Flexible Environments allow users to create and manage environments outside the regular left-to-right deployment flow. This enhancement provides flexibility in orchestrating code and content workflows, empowering developers and content editors to work in a way that best suits their needs.
 
-{% hint style="info" %}
-Limitations
+While the mainline environments use a horizontal deployment flow, the flexible environments will work a little differently. A flexible environment will be added to one of the existing mainline environments and only deploy to and from that environment. Get an overview of the different types of environments in the [Environments](environments.md) article.
 
-* Only one flexible environment is available.
-* Flexible environments are only available to Projects paid with Invoices or Credits.
-* CI/CD Pipelines are not supported.
-{% endhint %}
+![A Cloud project set up with 2 mainline environments and 1 flexible environment](images/cloud-environments.png)
+
+The image above shows a project setup including 2 mainline environments and 1 flexible environment attached to the left-most mainline environment.
 
 With Flexible Environments, teams can create environments as needed, allowing for more efficient and tailored workflows.
 
@@ -30,16 +28,28 @@ This feature enables:
 * **Easier hotfixes and feature releases**: Urgent fixes can be deployed directly without being blocked by unfinished work in other environments.
 * **Improved Content Management**: Content editors can create, test, and validate content changes without depending on a specific environment.
 
+## How it works
+
+* A flexible environment is added and therefor connected to a single mainline environment.
+* Developers develop and build features in the flexible environment without affecting the mainline environment.
+* Once a feature is complete, it can be merged back into the mainline environment and become part of regular deployment flow.
+* When there are changes made on the mainline environment, these need to be pulled into the flexible environment before changes can be pushed.
+
+Learn more about the deployment process in the [Deployments](../deployment/README.md) section.
+
 ## Project Prerequisites
 
 Before you can add a Flexible environment to your project, the following prerequisites must be met:
 
-* Uses Umbraco Version 10, 13, 14 or greater.
+* Uses Umbraco Version 10, 13, 14 or greater.
 * Uses Deploy Version Greater than 10.4.1, 13.3.0, 14.2.0 or greater.
 
-{% hint style="info" %}
-Flexible Environments are not available on Heartcore projects.
-{% endhint %}
+### Limitations
+
+* Only one flexible environment is available.
+* Flexible environments are only available to Projects paid with Invoices or Credits.
+* CI/CD Pipelines are not supported.
+* Flexible Environments are not available on Heartcore projects.
 
 ## Plans and Availability