-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
priority/criticalMust fix immediatelyMust fix immediatelysolution/workspaceCross-repo / org-wideCross-repo / org-widetype/infraCI/CD, workflows, repo configCI/CD, workflows, repo config
Description
Epic: Rewrite Org-Wide Standards (Clean Room)
Problem
The standards/ folder in azurelocal.github.io is the single authoritative source of truth for the entire AzureLocal organization (established in #14). Every repo links to azurelocal.cloud/standards/ for naming conventions, documentation standards, scripting standards, variable management, infrastructure, provisioning, solutions, and the IIC fictional company policy.
However, the current standards/ content was migrated from a TierPoint private repo (#10, #11) and still contains TierPoint, ProdTech, and PCS references throughout. These files were meant to be used as reference only — not published as-is.
Objective
Rewrite ALL files in standards/ from scratch, using the existing content purely as reference material. The output must be:
- Zero references to TierPoint, ProdTech, PCS, tplabs, tpdemos, or any TierPoint-specific identifiers
- Branded exclusively as Azure Local Cloud / AzureLocal org
- Fictional company examples use Infinite Improbability Corp (IIC) only
- Published to
azurelocal.cloud/standards/as the clean, authoritative org-wide reference
Standards Categories (from #14)
| Category | Current File(s) | Status |
|---|---|---|
| Repo Structure | standards/repo-structure.mdx |
Needs rewrite |
| Naming Conventions | standards/documentation/naming-conventions.mdx |
Needs rewrite (v3.1 from TierPoint) |
| Documentation Standards | standards/documentation/*.mdx |
Needs rewrite |
| Scripting Standards | standards/scripting/*.mdx |
Needs rewrite |
| Variable Management | standards/variable-management/*.mdx + assets |
Needs rewrite (970+ vars, master-registry, schema) |
| Infrastructure | standards/infrastructure/*.mdx |
Needs rewrite |
| Provisioning | standards/provisioning/*.mdx |
Needs rewrite |
| Solutions | standards/solutions/*.mdx |
Needs rewrite |
| Fictional Company Policy | standards/fictional-company-policy.mdx |
Needs rewrite |
| Docusaurus Features | standards/docusaurus/*.mdx |
Needs rewrite |
Approach
- Audit: Catalog every TierPoint/ProdTech/PCS reference in every file under
standards/ - Rewrite: Rewrite each file clean — use existing content as reference, not as a template to find-replace
- Validate:
grep -rfor all banned terms must return ZERO matches - Build:
npm run buildmust pass (onBrokenLinks: 'throw') - Ship: Commit, push, verify deploy, then delete the old reference content
Child Issues
- [INFRA] Establish unified project-wide standards across all AzureLocal repositories #14 — Establish unified project-wide standards across all AzureLocal repositories
Completed Work
- ✅ 9 standardized
docs/standards/files created across all 6 repos (5 solution repos + central site) - ✅ All 5 solution repos committed and pushed with byte-identical standards files
- ✅ Central site
docs/standards/created with Docusaurus MDX conversion - ✅ IIC fictional company info verified across all repos
Acceptance Criteria
- All files under
standards/are rewritten with zero TierPoint/ProdTech/PCS references -
grep -ri "tierpoint|prodtech|pcs|tplabs|tpdemos|28217fed" standards/returns ZERO - All standards categories from [INFRA] Establish unified project-wide standards across all AzureLocal repositories #14 have a unified, clean document
- Variable management suite ([INFRA] Standardize variable management, naming, and structure across all repositories #15) is clean with IIC examples only
- Site builds cleanly and deploys to azurelocal.cloud
- Every repo's README/CONTRIBUTING links to the clean standards
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
priority/criticalMust fix immediatelyMust fix immediatelysolution/workspaceCross-repo / org-wideCross-repo / org-widetype/infraCI/CD, workflows, repo configCI/CD, workflows, repo config