Merge pull request #510 from zihanKuang/add-workspace-delete

Improve Workspace Docs: Add Deletion Info, Fix Typos, and Update Alerts

Author: leecalcote

content/en/cloud/spaces/workspaces.md

@@ -6,32 +6,42 @@ weight: 6
 categories: [Spaces]
 ---
 
-Meshery Workspaces serve as a virtual space for your team-based work. Create a Workspace to organize your work and to serve as the central point of collaboration for you and your teams and a central point of access control to Environments and their resources.
 
-You may create Workspaces to organize project-based work or to create domains of responsibility for your teams or segregate Designs and Environments and track team activity.
+Meshery Workspaces provide a virtual space for you and your teams to collaborate, organize project-based work, manage access to environments and resources, and track team activities.
 
-## Summary
-
-Workspaces facilitate collaboration between you and your teams, allow you to control access to resources, and track activity and report on related events.
+You can create Workspaces to group related Designs and Environments, define domains of responsibility for your teams, and streamline resource management.
 
 ## Key Features
 
-- **Resource Sharing** Workspaces allow for seamless resource sharing among team members, fostering collaboration.
-- **Logical Grouping** Within Workspaces, you can group related components such as environments and infrastructure designs.
-- **Flexibility**: Workspaces support various resources like Kubernetes, Prometheus, Jaeger, Nginx, and more.
-- **Simplified Management** Managing and deploying resources is made easy within Workspaces.
-- **Access Control** Workspaces allow you to control access to resources by granting permissions to users and teams.
+- **Resource Sharing:** Workspaces allow for seamless resource sharing among team members, fostering collaboration.
+- **Logical Grouping:** Within Workspaces, you can group related components such as environments and infrastructure designs.
+- **Flexibility:** Workspaces support various resources like Kubernetes, Prometheus, Jaeger, Nginx, and more.
+- **Simplified Management:** Managing and deploying resources is made easy within Workspaces.
+- **Access Control:** Workspaces allow you to control access to resources by granting permissions to users and teams.
 
 ### Workspace Relationships and Restrictions
 
 - Access to Workspaces may be granted to one or more teams.
 - As a point of collaboration to facilitate work, Workspaces may have zero or more Environments associated.
 - A Workspace is closely associated with Teams in Meshery. Teams are groups of users with varying permissions, and they are at the center of resource access and management within a Workspace.
-- One ore more teams can be assigned to a workspace.
-- Same team can be assigned to multiple workspaces.
-- A team can be assigned to a workspace only if the team is not already assigned to another workspace.
+- One or more teams can be assigned access to a workspace.
+
+After creating a Workspace, one of your next steps is to assign team access, create or transfer designs into the Workspace, and allocate resources that to Workspace by associating it with one or more Environments, therein making the Environment's connections available to users of the Workspace. 
+
+Like a shared drive (or shared collection of files), Workspaces are your Google Drive, while Meshery Designs are your Google Docs.
+
+### Workspace Deletion Behavior
 
-After creating a Workspace, of your next steps is to resource that Workspace. Like a shared drive (or or shared collection of files). Workspaces are your Google Drive, while Meshery Designs are your Google Docs.
+When a Workspace is deleted:
+
+- Deletion is **permanent and irreversible**. Proceed with caution.
+- Before deletion, users have the option to transfer associated Designs and Views to another Workspace.
+- If no transfer is made, all associated Designs and Views will be permanently deleted along with the Workspace[^1].
+- Any associated Teams or Environments will be detached from the Workspace but will remain available for reassignment.
+
+{{< alert type="info" title="What Happens When a Workspace is Deleted?" >}}
+Deleting a Workspace will permanently remove the Workspace itself and its associated Designs and Views, unless they are transferred beforehand. Teams and Environments will remain intact but will no longer be associated with the deleted Workspace.
+{{< /alert >}}
 
 ## Key Workspace Components
 
@@ -41,28 +51,28 @@ After creating a Workspace, of your next steps is to resource that Workspace. Li
 - One or more environments can be assigned to a workspace.
 - Same environment can be assigned to multiple workspaces.
 
-{{< alert type="info" >}}
+{{< alert type="info" title="Assigning Environments to Workspaces" >}}
 Assign any number of Environments to one or more Workspaces. See [Environments](https://docs.meshery.io/concepts/environments) section for more information.
 {{< /alert >}}
 
 ### Designs
 
 - Infrastructure Designs are essential for creating reusable deployment templates. Users belonging to teams with access to a workspace can utilize these designs to deploy resources in the Kubernetes clusters associated with that workspace.
-- Like a shared drive (or or shared collection of files), Workspaces are your Google Drive, while Meshery Designs are your Google Docs.
-- One ore more designs can be assigned to a workspace.
-- Same design can be assigned to multiple workspaces.
+- Like a shared drive (or shared collection of files), Workspaces are your Google Drive, while Meshery Designs are your Google Docs.
+- One or more designs can be assigned to a workspace.
+- The Same design can be assigned to multiple workspaces.
 
-{{< alert type="info" >}}
+{{< alert type="info" title="Design Ownership in Workspaces" >}}
 Designs belong to only one Workspace at any given time. See [Meshery Designs](https://docs.meshery.io/concepts/designs) section for more information.
 {{< /alert >}}
 
 ### Teams 
 - A Workspace is closely associated with Teams in Meshery. Teams are groups of users with varying permissions, and they are at the center of resource access and management within a Workspace.
-- One ore more teams can be assigned to a workspace.
+- One or more teams can be assigned to a workspace.
 - Same team can be assigned to multiple workspaces.
 
-{{< alert type="info" >}}
-Teams offer control access to workspaces and to workspace resources such as environments and managed and unmanaged connections, See [Teams](/cloud/identity/teams).
+{{< alert type="info" title="Team Access Control in Workspaces" >}}
+Teams offer control access to workspaces and to workspace resources such as environments and managed and unmanaged connections. See [Teams](/cloud/identity/teams).
 {{< /alert >}}
 
 ### Connections
@@ -71,7 +81,7 @@ Teams offer control access to workspaces and to workspace resources such as envi
 - Connections can be assigned to one or more environments.
 - Same connection can be assigned to multiple environments.
 
-{{< alert type="info" >}}
+{{< alert type="info" title="Learn More About Connections" >}}
 See [Connections](https://docs.meshery.io/concepts/logical/connections) section for more information.
 {{< /alert >}}
 
@@ -84,3 +94,5 @@ To make the most of Meshery Workspaces, here are some best practices:
 - Regularly review and update your Workspace's resources and configurations.
 
 Meshery Workspaces enhance collaboration within your teams, providing a structured environment for sharing and managing resources. By following best practices and understanding the core components of Workspaces, you can maximize the benefits of this feature in Meshery.
+
+[^1]: This functionality is not fully implemented yet. Users might occasionally observe that designs and views are preserved after Workspace deletion.