fix: align management group ids (#109)

Update the IDs of the management groups to match the other RIs

---------

Co-authored-by: Matt White <[email protected]>

.github/workflows/pr-check.yml

@@ -48,14 +48,13 @@ jobs:
       matrix:
         lib: ${{ fromJson(needs.libschanged.outputs.list) }}
     steps:
-      - name: Install alzlibtool
-        run: |
-          curl -L https://github.com/Azure/alzlib/releases/download/${{ vars.ALZLIBTOOL_VERSION }}/alzlibtool_linux_amd64.tar.gz | tar -xvz
-          sudo cp alzlibtool /usr/local/bin
-
       - name: Checkout code
         uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
 
+      - name: Install alzlibtool
+        run: |
+          make tools
+
       - name: Azure login
         uses: azure/login@6c251865b4e6290e7b78be643ea2d005bc51f69a # v2.1.1
         with:
@@ -65,23 +64,11 @@ jobs:
 
       - name: Check README
         run: |
-          alzlibtool document library . > README.md
-          if [ -z "$(git status -suno)" ]; then
-            echo "README.md is up to date"
-          else
-            echo "README.md is out of date, generate using 'alzlibtool document library . >README.md'"
-            git --no-pager diff
-            exit 1
-          fi
+          make docs-check LIB="platform/${{ matrix.lib }}"
         shell: bash
-        working-directory: platform/${{ matrix.lib }}
-        env:
-          LIBRARY_PATH: platform/${{ matrix.lib }}
+
 
       - name: Check lib
         run: |
-          alzlibtool check library .
+          make lib-check LIB="platform/${{ matrix.lib }}"
         shell: bash
-        working-directory: platform/${{ matrix.lib }}
-        env:
-          LIBRARY_PATH: platform/${{ matrix.lib }}

.gitignore

@@ -4,3 +4,4 @@
 
 # Custom VSCode launch settings
 .vscode/launch.json
+alzlibtool

CONTRIBUTING.md

@@ -12,3 +12,23 @@ instructions provided by the bot. You will only need to do this once across all
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
 or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
+
+# Setup and build
+
+Run the following command to install the tools required to build the project:
+
+```bash
+make tools
+```
+
+Run the following command to build the docs:
+
+```bash
+make docs
+```
+
+To just build the docs for one library, run:
+
+```bash
+make docs LIB=alz
+```

Makefile

@@ -1,4 +1,22 @@
-.PHONY: server
+ALZ_LIB_TOOL_VERSION := v0.24.0
+
+.PHONY: server tools docs docs-check lib-check
 server:
 	@echo "Starting Hugo docs server..."
 	cd docs && hugo server && cd ..
+
+tools:
+	@echo "==> installing required tooling..."
+	curl -L https://github.com/Azure/alzlib/releases/download/$(ALZ_LIB_TOOL_VERSION)/alzlibtool_linux_amd64.tar.gz | sudo tar -C /usr/local/bin -xvz alzlibtool
+
+docs:
+	@echo "==> building docs $(LIB)..."
+	bash ./scripts/build-docs.sh $(LIB)
+
+docs-check:
+	@echo "==> checking docs $(LIB)..."
+	bash ./scripts/check-docs.sh $(LIB)
+
+lib-check:
+	@echo "==> checking library $(LIB)..."
+	bash ./scripts/check-lib.sh $(LIB)

platform/alz/README.md

@@ -26,12 +26,12 @@ The following architectures are available in this library, please note that the
   
 ```mermaid
 flowchart TD
-  alzroot["Azure Landing Zones
+  alz["Azure Landing Zones
 (root)"]
-  alzroot --> decommissioned
+  alz --> decommissioned
   decommissioned["Decommissioned
 (decommissioned)"]
-  alzroot --> landingzones
+  alz --> landingzones
   landingzones["Landing zones
 (landing_zones)"]
   landingzones --> corp
@@ -40,7 +40,7 @@ flowchart TD
   landingzones --> online
   online["Online
 (online)"]
-  alzroot --> platform
+  alz --> platform
   platform["Platform
 (platform)"]
   platform --> connectivity
@@ -52,9 +52,9 @@ flowchart TD
   platform --> management
   management["Management
 (management)"]
-  alzroot --> sandboxes
-  sandboxes["Sandboxes
-(sandboxes)"]
+  alz --> sandbox
+  sandbox["Sandbox
+(sandbox)"]
 
 ```
 
@@ -406,9 +406,9 @@ flowchart TD
 - Subscription-Owner
 </details>
 
-### archetype `sandboxes`
+### archetype `sandbox`
 
-#### sandboxes policy assignments
+#### sandbox policy assignments
 
 <details><summary>1 policy assignments</summary>