Skip to content

[Child of #651] Audit: Labeling Docs - Consolidate Overlapping Files #664

Open

Description

@ashleyshaw

Overview

Audit all documentation related to labeling to identify duplication, consolidate into a single source of truth, and eliminate redundancy.

Scope

Review all labeling related files:

  • docs/LABEL_STRATEGY.md
  • docs/LABELING.md
  • docs/ISSUE_LABELS.md
  • docs/PR_LABELS.md
  • docs/AUTOMATION_GOVERNANCE.md (label section)
  • Agent specs for labeling

Audit Checklist

  • Read through all 6 files listed above
  • Identify overlapping content between files
  • Document what information is in each file
  • Note cross-references and links between files
  • Identify the "source of truth" for each topic
  • Identify gaps or missing information
  • Propose consolidation strategy
  • Recommend which file should be primary reference

Deliverables

  • Labeling documentation audit report
  • Content matrix: File | Topic | Is Unique | Is Duplicated | Should Be Where
  • List of files that could be merged
  • Proposed unified structure for labeling docs

Related Files

  • docs/LABEL_STRATEGY.md
  • docs/LABELING.md
  • docs/ISSUE_LABELS.md
  • docs/PR_LABELS.md
  • docs/AUTOMATION_GOVERNANCE.md
  • .github/agents/labeling.agent.md (if exists)

Related Documentation


Definition of Ready (DoR)

  • Clear problem statement and expected outcome
  • Acceptance criteria defined
  • Related issues/dependencies identified
  • Required resources/approvals listed

Definition of Done (DoD)

  • All acceptance criteria met
  • Changes tested and validated
  • Documentation updated
  • Changes merged and deployed
  • Stakeholders notified

Activity

  1. linear-code commented on May 31, 2026

    @linear-code
  2. added 5 commits that reference this issue on May 31, 2026
  3. added this to the milestone on Jun 1, 2026
  4. ashleyshaw commented on Jun 3, 2026

    @ashleyshaw
    MemberAuthor

    Phase 1 deliverable completed.\n\nDeliverable report:\n- https://github.com/lightspeedwp/.github/blob/develop/.github/reports/audits/2026-06-03-labeling-docs-consolidation-audit-664.md\n\nIncludes:\n- overlap audit findings\n- consolidation matrix\n- proposed unified source-of-truth structure

  5. ashleyshaw commented on Jun 3, 2026

    @ashleyshaw
    MemberAuthor

    Status update (2026-06-03): Changes affecting this issue are now merged into develop via PR #814 (commit ea285b6). Current issue state remains as-is and reflects the delivered work.

  6. github-actions commented on Jun 19, 2026

    @github-actions
    Contributor

    ⚠️ This issue does not follow a required issue template.

    Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)

    The issue will remain open and flagged until the body is corrected.
    Please update the issue with one of the official templates:

    If this was opened by automation, update the automation to preserve the template sections before creating the issue.

  7. modified the milestones: , v1.1 on Jul 22, 2026
  8. self-assigned this
    on Sep 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

Fields

Priority

None yet

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions