Repository navigation
[Wave 5.2.4] Update Supporting Documentation #685
Description
Overview
Update all supporting documentation files to reflect audit findings and completed Wave 5.2 work.
Context
Wave 5.2 audit identified multiple documentation files that need updating:
- docs/LABEL_STRATEGY.md — incomplete
- docs/ISSUE_FIELDS.md — needs field mapping rationale
- docs/ISSUE_TYPES.md — needs type-to-project-field mapping and decision tree
Acceptance Criteria
- docs/LABEL_STRATEGY.md: Complete with color family strategy and assignment rules
- docs/ISSUE_FIELDS.md: Document field mapping rationale and type collapse reasoning
- docs/ISSUE_TYPES.md: Add type-to-project-field mapping and naming guidelines
- docs/LABEL_INVENTORY.md: Create with all 150 labels organized by family
- All files pass frontmatter validation
- All files pass markdown linting
- Cross-references verified (no broken links)
Technical Details
Documentation Structure:
- LABEL_STRATEGY.md: color families, rationale, assignment matrix
- ISSUE_FIELDS.md: field mapping table, collapse explanation, automation rules
- ISSUE_TYPES.md: type definitions, color assignments, project field mappings, decision tree
- LABEL_INVENTORY.md: 150 labels grouped by status/priority/type/area/language/discussion
Effort Estimate
- 3 hours
Related
- Parent: [Audit] Canonical Config Files (labels, issue-types, issue-fields) #650 (Wave 5.2: Canonical Config Files Audit)
- Depends on: 5.2.1 (Color Strategy), 5.2.2 (Type Mapping), 5.2.3 (Naming)
- Blocks: None (final deliverable)
Generated by Claude Code
https://claude.ai/code/session_01QBPjNAFgVUmE7RP658hut9"
Activity
linear-code commentedon May 31, 2026
LS-851
docs: update execution plan with Wave 5.2 completion and child issues (…
feat(#682): Wave 5.2.1 - Implement Color Strategy Specification (#689)
feat(#683): Wave 5.2.2 - Reconcile Issue-Fields Type Mapping
feat(#683): Wave 5.2.2 - Reconcile Issue-Fields Type Mapping
feat(#683): Wave 5.2.2 - Reconcile Issue-Fields Type Mapping
feat(#683): Wave 5.2.2 - Reconcile Issue-Fields Type Mapping (#690)
fix(#685): Remove incorrectly-named ISSUE-FIELDS.md
docs(#685): Wave 5.2.4 - Update Supporting Documentation (#695)
docs: update execution plan with Wave 5.2 completion and child issues (…
feat(#682): Wave 5.2.1 - Implement Color Strategy Specification (#689)
feat(#683): Wave 5.2.2 - Reconcile Issue-Fields Type Mapping (#690)
docs: Add label strategy and inventory documentation for Wave 5.2.4
ashleyshaw commentedon Jun 1, 2026
Status Update — Documentation Complete
✅ Wave 5.2.4 documentation updates completed in PR #700:
Changes Applied
docs/ISSUE_FIELDS.md
status,language)docs/ISSUE_TYPES.md
docs/LABEL_STRATEGY.md & docs/LABEL_INVENTORY.md
status,language)Outstanding CI Context
Pre-existing repository issues (broken links, project file frontmatter errors) are documented separately in issue #706. PR #700 itself passes all validation checks related to the changes made.
Updated via Claude Code — Documentation wave complete, awaiting merge
Generated by Claude Code
docs: Add type-to-project-field mapping and decision tree to Issue Ty…
docs: Add label strategy and inventory documentation for Wave 5.2.4
docs(#685): Add type-to-project-field mapping and decision tree
ashleyshaw commentedon Jun 1, 2026
✅ Merged — Wave 5.2.4 Documentation Complete
PR #700 has been successfully merged to the
developbranch with commit92fb2872ccb50a12652eb0de6f116a5136052798.Deliverables Completed:
✅ Type-to-project-field mapping documented in ISSUE_FIELDS.md (all 32 types → 10 project fields)
✅ Comprehensive decision tree added to ISSUE_TYPES.md for type selection
✅ Master reference tables showing type taxonomy and mappings
✅ Label strategy and inventory enhanced with accessibility improvements
✅ All documentation frontmatter updated with correct dates and versions
Work Status: Wave 5.2.4 documentation updates now live in develop.
Merged via Claude Code
Generated by Claude Code
docs: Fix frontmatter validation and project field mappings for 32-ty…
ashleyshaw commentedon Jun 3, 2026
Completed and verified on develop.\n\nDelivered and/or aligned items:\n- docs/LABEL_STRATEGY.md present and updated for strategy rules\n- docs/ISSUE_FIELDS.md present with field-mapping rationale\n- docs/ISSUE_TYPES.md present with type mapping guidance\n- docs/LABEL_INVENTORY.md present and updated; latest canonical alignment merged in PR #814\n- Markdown/frontmatter/link validations are green in recent CI runs for the merged work\n\nFinal alignment merge: PR #814 (docs: align type:qa references with type:test mapping) merged at 2026-06-03T19:23:51Z.\n\nClosing this issue as complete.
ashleyshaw commentedon Jun 3, 2026
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.
docs(labels): align supporting docs with WCAG colour strategy (#685)
fix(labels): WCAG 2.2 AA colour alignment and supporting docs update (#…