Merge pull request #2419 from strapi/cloud/variables-revamp

Strapi Cloud settings: Environment Variables revamp

Author: meganelacheny

docusaurus/docs/cloud/projects/settings.md

@@ -414,8 +414,23 @@ Environment variables (more information in the [Developer Documentation](../../d
   }}
 />
 
-In the <Icon name="code" classes="ph-bold" /> *Variables* tab, you can:
-- click the **Add variable** button to create a new variable
-- edit any variable, each being composed of a *Name* and a *Value*
-- click the <Icon name="trash-simple" /> delete button associated with any non-default variable to delete it
-- click the **Save** button to save any change made on the page
+In the <Icon name="code" classes="ph-bold" /> *Variables* tab are listed both the default and custom environment variables for your Strapi Cloud project. Each variable is composed of a *Name* and a *Value*.
+
+#### Managing environment variables
+
+Hovering on an environment variable, either default or custom, displays the following available options:
+
+- <Icon name="eye" /> **Show value** to replace the `*` characters with the actual value of a variable.
+- <Icon name="copy" /> **Copy to clipboard** to copy the value of a variable.
+- <Icon name="dots-three" /> **Actions** to access the <Icon name="pencil-simple" /> Edit and <Icon name="trash-simple" /> Delete buttons. Both options are only available for custom environment variables.
+  - When editing a variable, don't forget to confirm the changes by clicking on **Save**.
+  - When deleting a variable, you will be asked to click on a **Confirm** button to confirm the deletion.
+
+#### Creating custom environment variables
+
+Custom environment variables can be created for the Strapi Cloud project. Make sure to redeploy your project after creating or editing an environment variable.
+
+1. In the *Custom environment variables* section, click on the **Add variable** button.
+2. Write the *Name* and *Value* of the new environment variable in the same-named fields.
+3. (optional) Click on **Add another** to directly create one or more other custom environment variables.
+4. Click on the **Save** button to confirm the creation of the custom environment variables.