AzureLocal Platform¶

Centralized standards, reusable workflows, test frameworks, and scaffolding for the AzureLocal organization.

This is the documentation site for AzureLocal/platform — the single home for everything shared across the ~28 repos in the AzureLocal GitHub organization.

For AzureLocal repo maintainers¶

What is platform — overview, scope, non-goals
Why platform exists — the drift problem this fixes
Adopt platform from an existing repo — step-by-step
Create a new repo — end-to-end bootstrap
Consuming reusable workflows — copy-paste examples per repo type

For contributors to platform itself¶

Architecture overview — how platform relates to .github, product repos, and the docs site
ADR process — how to propose cross-cutting decisions
Local setup — clone, build docs, run tests
Release process — how platform ships

Sections¶

StandardsReusable workflowsMAPROOMTRAILHEADTemplatesRepo management

Canonical organizational standards — single source of truth. Browse standards.

GitHub Actions reusable workflows for PS module CI, TS web CI, IaC validate, MkDocs deploy, MAPROOM run, and drift check. Workflow catalog.

Offline fixture-based testing framework. MAPROOM overview.

Live-cluster validation cycles. TRAILHEAD overview.

Five repo-type starter skeletons. Template variants.

Org-wide automation — audit, sync, bootstrap. Repo management overview.

Companion repo¶

AzureLocal/.github owns GitHub-metadata governance (community-health files, org-level reusable workflows). Platform owns developer tooling. The split rule is documented in reusable-workflows/split-rule.md.