chore(standards): replace local standards/ with platform stub (Phase 1)#23
Conversation
…eLocal/platform Phase 1 of the platform rollout (ADR-0002). Deletes the local copies of org-wide standards docs and replaces them with a STANDARDS.md stub linking to the canonical source in AzureLocal/platform/standards/. The previous .md files were duplicates of azurelocal.github.io/standards/ that had drifted. The canonical copies now live (and are authored) in AzureLocal/platform; this repo consumes them by reference. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Phase 1 of the standards single-source rollout by removing the repo-root standards/ documentation set and replacing it with a root-level STANDARDS.md stub that points readers to the centralized standards in AzureLocal/platform.
Changes:
- Deleted the repo-root
standards/*.mdpages (previously a local copy of org standards). - Added
STANDARDS.mdat the repo root linking to the canonical standards source inAzureLocal/platform.
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| standards/automation.md | Deleted repo-root local standards page. |
| standards/documentation.md | Deleted repo-root local standards page. |
| standards/examples.md | Deleted repo-root local standards page. |
| standards/index.md | Deleted repo-root standards index page. |
| standards/infrastructure.md | Deleted repo-root local standards page. |
| standards/naming.md | Deleted repo-root local standards page. |
| standards/scripting.md | Deleted repo-root local standards page. |
| standards/solutions.md | Deleted repo-root local standards page. |
| standards/variables.md | Deleted repo-root local standards page. |
| STANDARDS.md | Added stub pointing to AzureLocal/platform/standards and rendered standards site. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| @@ -0,0 +1,9 @@ | |||
| # Standards | |||
|
|
|||
| AzureLocal organization standards are maintained centrally in the [`AzureLocal/platform`](https://github.com/AzureLocal/platform) repository. This repo does **not** keep a local copy. | |||
There was a problem hiding this comment.
Line 3 states this repo “does not keep a local copy”, but the repo still contains a full local standards set under docs/standards/ (e.g., docs/standards/index.md, docs/standards/scripting.md, etc.). Please either remove/relocate those pages as part of this migration, or adjust the wording here to avoid an incorrect/misleading claim (e.g., clarify what “local copy” refers to).
| AzureLocal organization standards are maintained centrally in the [`AzureLocal/platform`](https://github.com/AzureLocal/platform) repository. This repo does **not** keep a local copy. | |
| AzureLocal organization standards are maintained centrally in the [`AzureLocal/platform`](https://github.com/AzureLocal/platform) repository. This repo does **not** maintain the canonical copy of those standards; any local standards pages are informational only. |
| - **Rendered for humans**: [azurelocal.cloud/standards](https://azurelocal.cloud/standards/) | ||
| - **Governance**: [ADR-0002 — Standards as single source of truth](https://github.com/AzureLocal/platform/blob/main/decisions/0002-standards-single-source.md) | ||
|
|
||
| Changes to any standard are PRs against `AzureLocal/platform`, not against this repo. |
There was a problem hiding this comment.
With standards/ at the repo root being deleted, there are still internal docs that tell readers to use standards/ for canonical standards and/or point at the old azurelocal.github.io/standards/ location (e.g., tools/vmfleet/repo-management/README.md:25, repo-management/README.md:18). Consider updating those references to point to this STANDARDS.md (or directly to AzureLocal/platform/standards) to prevent broken guidance.
| Changes to any standard are PRs against `AzureLocal/platform`, not against this repo. | |
| Changes to any standard should be made in [`AzureLocal/platform/standards`](https://github.com/AzureLocal/platform/tree/main/standards) via a PR against `AzureLocal/platform`, not against this repo. |
Phase 1 of the AzureLocal platform rollout per ADR-0002.
standards/(drifted duplicates of azurelocal.github.io/standards/)STANDARDS.mdat repo root — a 6-line stub linking toAzureLocal/platform/standards/From here on, standards edits are PRs against
AzureLocal/platform.Test plan
standards/folder remain)STANDARDS.mdlink-checks🤖 Generated with Claude Code