Lowercasing file names and making some changes to the structure

Author: cynthn

articles/governance/index.yml

@@ -40,6 +40,15 @@ productDirectory:
           text: Protect your resource hierarchy
         - url: ./management-groups/index.yml
           text: See more >
+    - title: Azure Service Groups
+      imageSrc: ./media/management-groups.svg
+      links:
+        - url: ./service-groups/overview.md
+          text: Manage Service Groups
+        - url: ./Manage Azure Service Groups/manage-service-groups.md
+          text: Protect your resource hierarchy
+        - url: ./management-groups/index.yml
+          text: See more >
     - title: Azure Policy
       imageSrc: ./media/azure-policy.svg
       links:

articles/governance/service-groups/SGmanage.md renamed to articles/governance/service-groups/manage-service-groups.md

@@ -1,24 +1,22 @@
 ---
-title: Manage Azure Service Groups 
+title: Manage Resouces Across Subscriptions and Resource Groups with Azure Service Groups 
 description: "Learn how to create, update, read, and delete Azure Service Groups and its members"
 author: rthorn17
 ms.author: rithorn
-ms.service: Service Groups
-ms.topic: overview #Don't change
+ms.service: governance  ## is service-groups going to be an official service slug?
+ms.topic: how-to
 ms.date: 05/19/2025
 ---
 
-# How to manage Azure Service Groups?
+# How to use Azure Service Groups to manage resources
 
-Service groups in Azure are a low-privilege-based grouping of resources across subscriptions. They provide a way to manage resources with minimal permissions, ensuring that resources can be grouped and managed without granting excessive access. This article helps you learn how to manage Service Groups and its members.  
+You can group resources, across subscriptions, by creating Azure Service Groups. They provide a way to manage resources with minimal permissions, ensuring that resources can be grouped and managed without granting excessive access. This article helps you learn how to manage Service Groups and its members.  
 
 For more information on service groups, see [Getting started with Service Groups](overview.md).
 
-> ![IMPORTANT]
-> Service Groups are currently in a Limited Preview state and require Tenant onboarding before trial. To request for onboarding please see [TBD Link](). 
->
-> This documentation will show how to manage service groups and its members using the Azure portal and REST APIs in the Preview.  CLI/ PowerShell/ Terraform support will be announced in a later release.   
-
+> [!IMPORTANT]
+> Service Groups is currently in PREVIEW. For more information about participating in the preview, see [TBD Link]().
+> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 
 ## Service Group Actions
@@ -32,7 +30,7 @@ This section shows you how to manage service group's actions create, read, updat
 - API Version: **2024-04-01-preview**
 - URL: https://management.azure.com/providers/Microsoft.Management/serviceGroups/[groupID]?api-version=2024-04-01-preview
 
-Request Body: 
+Request Body:
 ```json
 {
     "kind":[kind],
@@ -192,9 +190,9 @@ Service group members are resources, resource groups, or subscriptions that are
 |------|-------------------------|--------------------------------|
 |Structure| Hierarchical|Flexible and dynamic|
 |Inheritance|Yes|No|
-|Scope|Service Group property|	Extends resources, resource groups, and subscriptions as its own resource|
-|Use Case|	Governance management |	Aggregating resources across different scopes |
-|Flexibility| Rigid/Strict (One Parent, Many Children) |	Flexible (Many Parents, Many Children)|
+|Scope|Service Group property| Extends resources, resource groups, and subscriptions as its own resource|
+|Use Case| Governance management | Aggregating resources across different scopes |
+|Flexibility| Rigid/Strict (One Parent, Many Children) | Flexible (Many Parents, Many Children)|
 
 ### Child/Parent Relationship Using the "Parent" Property
 

articles/governance/service-groups/overview.md

@@ -18,11 +18,20 @@ Service groups in Azure are a low-privilege-based grouping of resources across s
 
 
 ## Key capabilities
-* **Flexible Membership**: Service Groups allow resources from different subscriptions to be grouped together, providing a unified view and management capabilities. They also allow the grouping of subscriptions, resource groups, and resources. 
-* **Low Privilege Management**: Service Groups are designed to operate with minimal permissions, ensuring that users can manage resources without needing excessive access rights.
-* **Multiple Hierarchies**: Service Groups live outside of the resource hierarchy enabling scenarios where the same resources need to be group for different purposes.   
+- **Multiple Hierarchies**: Service Groups live outside of the resource hierarchy enabling scenarios where the same resources need to be group for different purposes.*
+- **Flexible Membership**: Service Groups allow resources from different subscriptions to be grouped together, providing a unified view and management capabilities. They also allow the grouping of subscriptions, resource groups, and resources. 
+- **Low Privilege Management**: Service Groups are designed to operate with minimal permissions, ensuring that users can manage resources without needing excessive access rights.
 
 
+### Multiple Hierarchies 
+The same resources can be connected to many different service groups allowing different customer personas and scenarios to be created and used. With different Role Based Access Controls being assigned to the multiple Service Groups, customers can create many different views that support how they organize their resources.   
+
+#### Example Scenarios
+* Separate Personas 
+    * An issue that arose frequently when trying to adopt a strict hierarchy was who would own the parent items. With Service Groups, this situation no longer becomes an issue and the different personas can have their own individual views. Customers can use the same resources to be members of a Workload Service Group, a Department Service Group, and a Service Group with all Production resources. 
+
+![MultipleSGTree](./media/MultiSG.png)
+
 ### Flexible Membership
 Within the hierarchy of resources, there's a limitation of one parent resource container to many children. For example, a resource can only be a member of one resource group or a resource group can only be a member of one subscription. Service Groups introduce a new model that allows a resources or resource containers to have memberships with multiple different Service Groups. The Service Group allows new scenarios where the same resources can be connected to many Service Groups Trees enabling new ways to view your data.  
 
@@ -41,14 +50,6 @@ Service Groups don't have the same inheritance capabilities that other Azure Res
 * Aggregating monitoring metrics 
    * Since Service Groups don't inherit permissions to the members, customers can apply least privileges to assign permissions on the Service Groups that allow viewing of metrics. This capability provides a solution where two users can be assigned access to the same Service Group, but only one is allowed to see certain resources. 
 
-### Multiple Hierarchies 
-The same resources can be connected to many different service groups allowing different customer personas and scenarios to be created and used. With different Role Based Access Controls being assigned to the multiple Service Groups, customers can create many different views that support how they organize their resources.   
-
-#### Example Scenarios
-* Separate Personas 
-    * An issue that arose frequently when trying to adopt a strict hierarchy was who would own the parent items. With Service Groups, this situation no longer becomes an issue and the different personas can have their own individual views. Customers can use the same resources to be members of a Workload Service Group, a Department Service Group, and a Service Group with all Production resources. 
-
-![MultipleSGTree](./media/MultiSG.png)
 
 ## How it works
 Azure Service Groups are a separate hierarchy grouping resources that don't exist in the resource hierarchy with Resource Groups, Subscriptions, and Management Groups. The separation allows Service Groups to be connected many times to different resources and resource containers without impacting the existing structures.