edits

Author: v-albemi

articles/deployment-environments/best-practice-catalog-structure.md

@@ -1,6 +1,6 @@
 ---
-title: "Best practices for structuring an Azure Deployment Environments catalog"
-description: "This article provides guidelines for structuring an Azure Deployment Environments catalog for efficient caching."
+title: Best practices for structuring an Azure Deployment Environments catalog
+description: Get guidelines for structuring an Azure Deployment Environments catalog to help ensure efficient caching.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: azure-deployment-environments
@@ -11,15 +11,15 @@ ms.date: 03/20/2025
 
 ---
 
-# Best practices for Azure Deployment Environment catalogs
+# Best practices for Azure Deployment Environments catalogs
 
 This article describes best practices for structuring an Azure Deployment Environments catalog.
 
 ## Structure the catalog for efficient caching
 
-Platform engineers should structure catalogs in a way that makes it easier and quicker for Azure Deployment Environments to find and cache environment definitions efficiently. By organizing the repository into a specific structure, you can better target files for caching and improve the overall performance of the deployment process. To ensure optimal results, platform engineers need to understand these guidelines and structure their repositories accordingly.
+Platform engineers should structure catalogs in a way that makes it easier and quicker for Azure Deployment Environments to find and cache environment definitions. By organizing the repository into a specific structure, you can better target files for caching and improve the overall performance of the deployment process. To ensure optimal results, platform engineers need to understand these guidelines and structure their repositories accordingly.
 
-When you attach a catalog to a dev center, Deployment Environments scans the catalog for a manifest.yaml file. On locating the file, ADE assumes the files in that folder and subfolders form an environment definition. ADE caches only the required files, not the entire repository. 
+When you attach a catalog to a dev center, Deployment Environments scans the catalog for a manifest.yaml file. When it locates the file, Azure Deployment Environments assumes the files in that folder and subfolders form an environment definition. Azure Deployment Environments caches only the required files, not the entire repository. 
 
 The following diagram shows the recommended structure for a repo. Each template resides within a single folder.