From 433f59eefe21ab65f1ac2ae5ba8d52cfe496aa68 Mon Sep 17 00:00:00 2001 From: Luke Murray <24467442+lukemurraynz@users.noreply.github.com> Date: Thu, 31 Oct 2024 12:09:21 +1300 Subject: [PATCH] Update integrating-with-alz.md (#802) Updated with correct link. --- Docs/integrating-with-alz.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Docs/integrating-with-alz.md b/Docs/integrating-with-alz.md index 14d864c7..e3837bea 100644 --- a/Docs/integrating-with-alz.md +++ b/Docs/integrating-with-alz.md @@ -191,7 +191,7 @@ To deploy the ALZ policies using EPAC follow the steps below. ## Keeping up to date with changes manually -The Azure Landing Zone deployment contains a number of policies which help provide guardrails to an environment, and the team which works on these policies is always providing updates to the original content to keep in line with Microsoft best practice and road map. The EPAC solution contains a function to help synchronize changes from the upstream project +The Azure Landing Zone deployment contains several policies that help provide guardrails to an environment, and the team that works on these policies is always providing updates to the original content to keep in line with Microsoft's best practices and road maps. The EPAC solution contains a function to help synchronize changes from the upstream project. To pull the latest changes from the upstream repository - use the code below. @@ -202,19 +202,19 @@ Sync-ALZPolicies -DefinitionsRootFolder .\Definitions -CloudEnvironment AzureClo Carefully review the proposed changes before deploying them. It is best to make sure you're project is stored in source control so you can easily see which files have changed before deployment. > [!WARNING] -> If you have follow Scenario 1 above, the first time you run the `Sync-ALZPolicies` there will be many changes recorded due to formatting. Review the files completely before deploying. +> If you have followed Scenario 1 above, the first time you run the `Sync-ALZPolicies`, there will be many changes recorded due to formatting. Review the files completely before deploying. > [!WARNING] > Assignments deployed via the ALZ accelerators are kept in sync with the EnterprisePolicyAsCode module so ensure you have the latest PowerShell module installed before running `Sync-ALZPolicies` > [!TIP] -> Rename or copy the default ALZ assignment files - when you do a sync it makes it easier to compare changes. +> Rename or copy the default ALZ assignment files - when you do a sync, it makes it easier to compare changes. ## Keeping up to date with GitHub Actions There is a GitHub action workflow which executes the above script. The process for configuring it is below. -1. Copy the `alz-sync.yaml` file from [here](https://github.com/Azure/enterprise-azure-policy-as-code/blob/main/StarterKit/Pipelines/GitHubActions/.github/workflows/alz-sync.yaml) to `.github\workflows\alz-sync.yaml` in your repository. +1. Copy the `alz-sync.yaml` file from [here](https://github.com/Azure/enterprise-azure-policy-as-code/blob/main/StarterKit/Pipelines/GitHubActions/alz-sync.yaml) to `.github\workflows\alz-sync.yaml` in your repository. 2. Update the `env:` section with details below | Environment Variable Name | Value | Notes |