Skip to content

[EPIC] Rewrite org-wide standards - remove all TierPoint references #24

@kristopherjturner

Description

@kristopherjturner

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

  1. Audit: Catalog every TierPoint/ProdTech/PCS reference in every file under standards/
  2. Rewrite: Rewrite each file clean — use existing content as reference, not as a template to find-replace
  3. Validate: grep -r for all banned terms must return ZERO matches
  4. Build: npm run build must pass (onBrokenLinks: 'throw')
  5. Ship: Commit, push, verify deploy, then delete the old reference content

Child Issues

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions