Skip to content

chore(standards): replace local standards/ with platform stub (Phase 1)#23

Merged
kristopherjturner merged 1 commit intomainfrom
chore/phase-1-standards-stub
Apr 12, 2026
Merged

chore(standards): replace local standards/ with platform stub (Phase 1)#23
kristopherjturner merged 1 commit intomainfrom
chore/phase-1-standards-stub

Conversation

@kristopherjturner
Copy link
Copy Markdown
Contributor

Phase 1 of the AzureLocal platform rollout per ADR-0002.

  • Deletes standards/ (drifted duplicates of azurelocal.github.io/standards/)
  • Adds STANDARDS.md at repo root — a 6-line stub linking to AzureLocal/platform/standards/

From here on, standards edits are PRs against AzureLocal/platform.

Test plan

  • Repo still builds / docs still render (no internal link references into the deleted standards/ folder remain)
  • STANDARDS.md link-checks

🤖 Generated with Claude Code

…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>
Copilot AI review requested due to automatic review settings April 12, 2026 23:36
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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/*.md pages (previously a local copy of org standards).
  • Added STANDARDS.md at the repo root linking to the canonical standards source in AzureLocal/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.

Comment thread STANDARDS.md
@@ -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.
Copy link

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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).

Suggested change
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.

Copilot uses AI. Check for mistakes.
Comment thread STANDARDS.md
- **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.
Copy link

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Suggested change
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.

Copilot uses AI. Check for mistakes.
@kristopherjturner kristopherjturner merged commit 51572b7 into main Apr 12, 2026
5 of 6 checks passed
@kristopherjturner kristopherjturner deleted the chore/phase-1-standards-stub branch April 12, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants