Merge pull request #262714 from JnHs/jh-arc-janfre2

AnnaMHuff · web-flow · commit d9efc35832b0 · 2024-01-08T17:27:54.000-07:00
refresh articles
diff --git a/articles/azure-arc/platform/conceptual-custom-locations.md b/articles/azure-arc/platform/conceptual-custom-locations.md
@@ -2,34 +2,33 @@
 title: "Overview of custom locations with Azure Arc"
 services: azure-arc
 ms.service: azure-arc
-ms.date: 02/24/2022
+ms.date: 01/08/2024
 ms.topic: conceptual
 description: "This article provides a conceptual overview of the custom locations capability of Azure Arc."
 ---
 
 # Custom locations
 
-As an extension of the Azure location construct, a *custom location* provides a reference as deployment target which administrators can set up, and users can point to, when creating an Azure resource. It abstracts the backend infrastructure details from application developers, database admin users, or other users in the organization. 
+As an extension of the Azure location construct, a *custom location* provides a reference as a deployment target that administrators can set up when creating an Azure resource. The custom location feature abstracts the backend infrastructure details from application developers, database admin users, or other users in the organization. These users can then reference the custom location without having to be aware of these details.
 
-Since the custom location is an Azure Resource Manager resource that supports [Azure role-based access control (Azure RBAC)](../../role-based-access-control/overview.md), an administrator or operator can determine which users have access to create resource instances on:
+Custom locations can be used to enable [Azure Arc-enabled Kubernetes clusters](../kubernetes/overview.md) as target locations for deploying Azure services instances. Azure offerings that can be deployed on top of custom locations include databases, such as [SQL Managed Instance enabled by Azure Arc](/azure/azure-arc/data/managed-instance-overview) and [Azure Arc-enabled PostgreSQL server](/azure/azure-arc/data/what-is-azure-arc-enabled-postgresql).
 
-* A namespace within a Kubernetes cluster to target deployment of SQL Managed Instance enabled by Azure Arc and Azure Arc-enabled PostgreSQL servers.
-* The compute, storage, networking, and other vCenter or Azure Stack HCI resources to deploy and manage VMs.
+On Arc-enabled Kubernetes clusters, a custom location represents an abstraction of a namespace within the Azure Arc-enabled Kubernetes cluster. Custom locations create the granular [RoleBindings and ClusterRoleBindings](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#rolebinding-and-clusterrolebinding) necessary for other Azure services to access the cluster.
 
-For example, a cluster operator could create a custom location **Contoso-Michigan-Healthcare-App** representing a namespace on a Kubernetes cluster in your organization's Michigan Data Center. The operator can then assign Azure RBAC permissions to application developers on this custom location so that they can deploy healthcare-related web applications. The developers can then deploy these applications without having to know details of the namespace and Kubernetes cluster.
+## Custom location permissions
 
-On Arc-enabled Kubernetes clusters, a custom location represents an abstraction of a namespace within the Azure Arc-enabled Kubernetes cluster. Custom locations create the granular [RoleBindings and ClusterRoleBindings](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#rolebinding-and-clusterrolebinding) necessary for other Azure services to access the cluster.
+Since the custom location is an Azure Resource Manager resource that supports [Azure role-based access control (Azure RBAC)](../../role-based-access-control/overview.md), an administrator or operator can determine which users have access to create resource instances on:
+
+* A namespace within a Kubernetes cluster to target deployment of SQL Managed Instance enabled by Azure Arc or Azure Arc-enabled PostgreSQL server.
+* The compute, storage, networking, and other vCenter or Azure Stack HCI resources to deploy and manage VMs.
 
-> [!IMPORTANT]
-> In the interest of ensuring new features are documented no later than their release, this page may include documentation for features that may not yet be publicly available.
+For example, a cluster operator could create a custom location **Contoso-Michigan-Healthcare-App** representing a namespace on a Kubernetes cluster in your organization's Michigan Data Center. The operator can assign Azure RBAC permissions to application developers on this custom location so that they can deploy healthcare-related web applications. The developers can then deploy these applications to **Contoso-Michigan-Healthcare-App** without having to know details of the namespace and Kubernetes cluster.
 
 ## Architecture for Arc-enabled Kubernetes
 
-When an administrator enables the custom locations feature on a cluster, a ClusterRoleBinding is created, authorizing the Microsoft Entra application used by the Custom Locations Resource Provider (RP). Once authorized, Custom Locations RP can create ClusterRoleBindings or RoleBindings needed by other Azure RPs to create custom resources on this cluster. The cluster extensions installed on the cluster determines the list of RPs to authorize.
-
-[ ![Use custom locations](../kubernetes/media/conceptual-custom-locations-usage.png) ](../kubernetes/media/conceptual-custom-locations-usage.png#lightbox)
+When an administrator enables the custom locations feature on a cluster, a ClusterRoleBinding is created, authorizing the Microsoft Entra application used by the Custom Locations Resource Provider (RP). Once authorized, the Custom Locations RP can create ClusterRoleBindings or RoleBindings needed by other Azure RPs to create custom resources on this cluster. The cluster extensions installed on the cluster determine the list of RPs to authorize.
 
-[!INCLUDE [preview features note](../kubernetes/includes/preview/preview-callout.md)]
+[ ![Diagram showing custom locations architecture on Arc-enabled Kubernetes.](../kubernetes/media/conceptual-custom-locations-usage.png) ](../kubernetes/media/conceptual-custom-locations-usage.png#lightbox)
 
 When the user creates a data service instance on the cluster:
 
@@ -41,8 +40,9 @@ When the user creates a data service instance on the cluster:
    * The Azure Arc-enabled Data Services operator was deployed via cluster extension creation before the custom location existed.
 1. The Azure Arc-enabled Data Services operator reads the new custom resource created on the cluster and creates the data controller, translating into realization of the desired state on the cluster.
 
-The sequence of steps to create the SQL managed instance and PostgreSQL instance are identical to the sequence of steps described above.
+The sequence of steps to create the SQL managed instance or PostgreSQL instance are identical to the sequence of steps described above.
 
 ## Next steps
 
-* Use our quickstart to [connect a Kubernetes cluster to Azure Arc](../kubernetes/quickstart-connect-cluster.md). Then [create a custom location](../kubernetes/custom-locations.md) on your Azure Arc-enabled Kubernetes cluster.
+* Use our quickstart to [connect a Kubernetes cluster to Azure Arc](../kubernetes/quickstart-connect-cluster.md).
+* Learn how to [create a custom location](../kubernetes/custom-locations.md) on your Azure Arc-enabled Kubernetes cluster.
diff --git a/articles/azure-arc/resource-graph-samples.md b/articles/azure-arc/resource-graph-samples.md
@@ -1,16 +1,16 @@
 ---
 title: Azure Resource Graph sample queries for Azure Arc
 description: Sample Azure Resource Graph queries for Azure Arc showing use of resource types and tables to access Azure Arc related resources and properties.
-ms.date: 07/07/2022
+ms.date: 01/08/2024
 ms.topic: sample
 ms.custom: subject-resourcegraph-sample
 ---
 # Azure Resource Graph sample queries for Azure Arc
 
 This page is a collection of [Azure Resource Graph](../governance/resource-graph/overview.md) sample
 queries for Azure Arc. For a complete list of Azure Resource Graph samples, see
-[Resource Graph samples by Category](../governance/resource-graph/samples/samples-by-category.md)
-and [Resource Graph samples by Table](../governance/resource-graph/samples/samples-by-table.md).
+[Resource Graph sample queries by category](../governance/resource-graph/samples/samples-by-category.md)
+and [Resource Graph sample queries by table](../governance/resource-graph/samples/samples-by-table.md).
 
 ## Sample queries
 
@@ -20,5 +20,5 @@ and [Resource Graph samples by Table](../governance/resource-graph/samples/sampl
 
 - Learn more about the [query language](../governance/resource-graph/concepts/query-language.md).
 - Learn more about how to [explore resources](../governance/resource-graph/concepts/explore-resources.md).
-- See samples of [Starter language queries](../governance/resource-graph/samples/starter.md).
-- See samples of [Advanced language queries](../governance/resource-graph/samples/advanced.md).
+- See samples of [starter Resource Graph queries](../governance/resource-graph/samples/starter.md).
+- See samples of [Advanced Resource Graph queries](../governance/resource-graph/samples/advanced.md).
diff --git a/articles/azure-arc/validation-program/overview.md b/articles/azure-arc/validation-program/overview.md
@@ -1,30 +1,29 @@
 ---
 title: Azure Arc-enabled services validation overview
 description: Explains the Azure Arc validation process to conform to the Azure Arc-enabled Kubernetes, Data Services, and cluster extensions.
-ms.date: 07/30/2021
+ms.date: 01/08/2024
 ms.topic: overview
 ---
 
 # Overview of Azure Arc-enabled service validation
 
-Microsoft recommends running Azure Arc-enabled services on validated platforms. This article points you to content to explain how various Azure Arc-enabled components are validated. 
+Microsoft recommends running Azure Arc-enabled services on validated platforms whenever possible. This article explains how various Azure Arc-enabled components are validated.
 
-Currently, validated solutions are available from partners for Kubernetes and data services.
+Currently, validated solutions are available from partners for [Azure Arc-enabled Kubernetes](../kubernetes/overview.md) and [Azure Arc-enabled data services](../data/overview.md).
 
-## Kubernetes
+## Validated Azure Arc-enabled Kubernetes distributions
 
-Azure Arc-enabled Kubernetes works with any Cloud Native Computing Foundation (CNCF) certified Kubernetes clusters. The Azure Arc team has worked with key industry Kubernetes offering providers to validate Azure Arc-enabled Kubernetes with their [Kubernetes distributions](../kubernetes/validation-program.md). Future major and minor versions of Kubernetes distributions released by these providers will be validated for compatibility with Azure Arc-enabled Kubernetes.
+Azure Arc-enabled Kubernetes works with any Cloud Native Computing Foundation (CNCF) certified Kubernetes clusters. The Azure Arc team worked with key industry Kubernetes offering providers to [validate Azure Arc-enabled Kubernetes with their Kubernetes distributions](../kubernetes/validation-program.md?toc=/azure/azure-arc/toc.json&bc=/azure/azure-arc/breadcrumb/toc.json). Future major and minor versions of Kubernetes distributions released by these providers will be validated for compatibility with Azure Arc-enabled Kubernetes.
 
-## Data services
+## Validated data services solutions
 
-We have also partnered with original equipment manufacturer (OEM) partners and storage providers to validate [Azure Arc-enabled data services](../data/validation-program.md) solutions.
+The Azure Arc team worked with original equipment manufacturer (OEM) partners and storage providers to [validate Azure Arc-enabled data services solutions](../data/validation-program.md?toc=/azure/azure-arc/toc.json&bc=/azure/azure-arc/breadcrumb/toc.json). This includes partner solutions, versions, Kubernetes versions, SQL engine versions, and PostgreSQL server versions that have been verified to support the data services.
 
 ## Validation process
 
-The Azure Arc validation process is available in GitHub. To find out more details on how to validate your offering with Azure Arc, the test harness and strategy, please refer to the [Azure Arc validation process](https://github.com/Azure/azure-arc-validation/) in GitHub.
+For more details about the validation process, see the [Azure Arc validation process](https://github.com/Azure/azure-arc-validation/) in GitHub. Here you find information about how offerings are validated with Azure Arc, the test harness, strategy, and more.
 
 ## Next steps
 
-* [Validated Kubernetes distributions](../kubernetes/validation-program.md?toc=/azure/azure-arc/toc.json&bc=/azure/azure-arc/breadcrumb/toc.json)
-
-* [Validated Kubernetes distributions for data services](../data/validation-program.md?toc=/azure/azure-arc/toc.json&bc=/azure/azure-arc/breadcrumb/toc.json)
+* Learn about [Validated Kubernetes distributions](../kubernetes/validation-program.md?toc=/azure/azure-arc/toc.json&bc=/azure/azure-arc/breadcrumb/toc.json)
+* Learn about [validated solutions for data services](../data/validation-program.md?toc=/azure/azure-arc/toc.json&bc=/azure/azure-arc/breadcrumb/toc.json)
