Merge pull request #7012 from umbraco/manage-environments

Added configure environment section...

Author: eshanrnh

umbraco-cloud/getting-started/environments.md

@@ -12,7 +12,7 @@ You can have multiple environments in your Umbraco Cloud project, with two types
 
 The image below shows a Cloud setup including two mainline environments and one flexible environment connected to the left-most mainline environment.
 
-![A Cloud setup including 2 mainline environments and 1 flexible environment connected to the left-most mainline environment](images/cloud-environments.jpg)
+![A Cloud setup including 2 mainline environments and 1 flexible environment connected to the left-most mainline environment](images/cloud-environments.png)
 
 ## Mainline Environments
 

umbraco-cloud/set-up/images/create-environment.png

@@ -1,35 +1,54 @@
 # Manage Environments
 
-When working with an Umbraco Cloud project, you can add or remove extra environments depending on the plan you are in:
+The number of environments available on your project is dependent on which plan you are on:
 
-* For the Starter plan, you can add a Development environment for an additional price per month.
-* For the Standard plan, you get the Development environment for free and can add a Staging environment for an additional price per month.
-* For the Professional plan, you get the Development and Staging environment for free. Additionally, you can add and remove environments whenever you like without any additional cost.
+<table><thead><tr><th width="117">Plan</th><th width="116" data-type="number">Environments</th><th width="167" data-type="checkbox">Flexible Environments</th><th>Environment Combinations Examples</th></tr></thead><tbody><tr><td>Starter</td><td>2</td><td>false</td><td><em>QA + Production</em></td></tr><tr><td>Standard</td><td>3</td><td>true</td><td><em>Flexible + QA + Production</em><br><em>Development + QA + Production</em></td></tr><tr><td>Professional</td><td>4</td><td>true</td><td><em>Flexible + Development + QA + Production</em></td></tr></tbody></table>
 
-[Learn more about the additional prices on Umbraco Cloud](https://umbraco.com/cloud-pricing/).
+[Learn more about Umbraco Cloud Pricing](https://umbraco.com/cloud-pricing/).
 
-{% embed url="https://www.youtube.com/watch?v=avzRNFR-FSY" %}
-Adding an additional environment to a Cloud project
-{% endembed %}
+## Configuring Environments
+
+Clicking Configure environments from the project overview gives you access to environment management options. From here, you can:
+
+- Rename an existing environment.
+- Create a new environment.
+- Delete an environment you no longer need.
+
+These options help keep your deployment pipeline organized and aligned with your team's workflow.
 
 ## Adding or Removing Environments
 
-**Important:** _Before_ adding an environment, you should consider if you have any changes locally that are not on Live yet. If you do, you should make sure to push it as adding another environment will also push it into the deployment chain.
+Most Umbraco Cloud plans give you the flexibility to work with multiple environments. You can decide how many to add and how to organize them as flexible or mainline environments. For more information on environment types, see the [Environments](../getting-started/environments.md) article.
+
+The following sections provide guidance on managing your Cloud environments.
+
+### Adding an Environment
+
+Before adding an environment, ensure there are no local changes that haven’t been pushed to Live. Adding an environment will push all changes in the current deployment chain.
+
+To add an environment:
+
+1. Click **Configure environments**.
+
+![Adding an environment](images/environments-overview-new.png)
+
+2. Click **Create environment**.
 
-**Important:** _After_ adding a Development environment, you need to do a fresh clone of the site. The local version you have will be set up to push directly to Live, a fresh clone will push to Development.
+![Create environment](images/create-environment.png)
 
-You can add environments from your project overview here:
+3. Choose an **Environment name**.
+4. Click **Confirm**.
 
-<figure><img src="../.gitbook/assets/image (16).png" alt="Adding environments"><figcaption><p>Adding environments</p></figcaption></figure>
+After adding a new left-most mainline environment or a flexible environment, you need to clone this environment instead. The current local clone will be set up to push to Live, while the fresh clone will push to the new environment.
 
-To remove an environment, go to the environment you want to delete click on the three dots, and click delete:
+### Removing an Environment
 
-<figure><img src="../.gitbook/assets/image (17).png" alt=""><figcaption></figcaption></figure>
+To remove an environment:
 
-{% hint style="info" %}
-There is a specific order that the environments are being added. You will need to have a Development environment before you can have a Staging environment.
-{% endhint %}
+1. Navigate to the environment you want to delete.
+2. Click on the three dots.
+3. Click **Delete**.
 
-Suppose you have both a Development and a Staging environment and need to remove the Development environment. In that case, you will first need to remove the Staging environment before you can remove the Development environment.
+![Deleting an environment](images/delete-environment.png)
 
-Once you have added or removed an environment, it will take a couple of minutes for Cloud to set it all up, and then you will be ready to use it.
+It may take a few minutes for Cloud to set up the changes after adding or removing an environment.