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

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions