Skip to content

Seven references point at a local docs/CODING_PRACTICES.md that does not exist in this repo #337

Closed

Description

@wz-gsa

Part of #335

What's wrong

Seven live references point at a local docs/CODING_PRACTICES.md, but that file does not exist in this repo. The links are dead.

Evidence (file:line)

  • File docs/CODING_PRACTICES.md is absent from this repo.
  • 7 live references:
    • CONTEXT-GUIDE.md:9, 31
    • CONTRIBUTING.md:39, 62, 282, 303, 317

Suggested fix

Point the references at the playbook's canonical CODING_PRACTICES.md via a cross-repo link, or add the file to this repo. Prefer the cross-repo link so the Playbook remains the single source of truth.


Surfaced via an automated audit (Fable) against a public clone; validated against main 2026-08-19. AI-assisted (OpenCode).

Activity

  1. wz-gsa commented on Aug 20, 2026

    @wz-gsa
    ContributorAuthor

    PR opened repointing the broken docs/CODING_PRACTICES.md refs to the canonical playbook URL. Scope note: the audit listed 7 refs; there were actually 9 live broken refs across 5 files — I fixed the CONTRIBUTING.md (5) + CONTEXT-GUIDE.md (table row + related_files). The 9th, checklists/pre-deployment.md:11, is deferred: it collides with open PR #344 (SA-12→SR-3, which also edits that file). I'll fold the line-11 fix in after #344 merges so we don't double-touch the file. Historical refs in CHANGELOG/ADR bodies left as-is.

  2. wz-gsa commented on Aug 20, 2026

    @wz-gsa
    ContributorAuthor

    8 of 9 broken refs fixed on main by merged PR #345 (CONTRIBUTING ×5 + CONTEXT-GUIDE table row + related_files → canonical playbook URL). Kept open for the 9th: checklists/pre-deployment.md:11 — was deferred to avoid colliding with PR #344, which has now MERGED, so this is unblocked for a small follow-up.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions