Skip to content

Getting started

New to AzureLocal/platform? Start here.

Pick your path

If you want to... Read
Understand what platform is and isn't What is platform
Understand why it exists (~28 repos, 7 duplicate standards/ folders, etc.) Why platform exists
See how the pieces fit together Architecture overview
Look up terminology (MAPROOM, TRAILHEAD, IIC, etc.) Glossary
Jump straight to links and shortcuts Quick links

Then decide your action

Role Next step
Consumer repo owner — adopting platform from an existing repo Onboarding → Adopt from an existing repo
Repo creator — spinning up a new AzureLocal repo Onboarding → Create a new repo
Platform contributor — editing platform itself Contributing → Local setup
Operator — running org-scripts, reading drift reports Repo management → Overview

Ten-minute tour

  1. README — what lives here
  2. Standards index — canonical rules
  3. Reusable workflows index — the six workflows
  4. MAPROOM overview — fixture-based testing
  5. TRAILHEAD overview — live-cluster cycles

Repo map

Folder Purpose
docs/ This site (MkDocs Material)
standards/ Canonical standards markdown
.github/workflows/reusable-*.yml The six reusable workflows
testing/maproom/ AzureLocal.Maproom PS module + schema
testing/trailhead/ Live-cluster harness
testing/iic-canon/ Canonical fictional-company fixtures
modules/powershell/AzureLocal.Common/ Shared PS helpers
repo-management/org-scripts/ Invoke-RepoAudit, Sync-Labels, etc.
templates/ 5 variants + _common for New-AzureLocalRepo.ps1
decisions/ ADRs