Skip to content

Conversation

@castrojo
Copy link
Contributor

Summary

Improves monthly report quality by adding missing label mappings and category descriptions.

Changes

  1. Add missing label mappings:

    • Added aarch64 to Hardware category (ARM64 architecture work)
    • Added kind/parity to Tech Debt category (feature parity between variants)
    • Both labels now have color mappings for consistent badge display
  2. Add category descriptions:

    • All 10 categories now show italic descriptions explaining their scope
    • Descriptions appear above Planned/Opportunistic split
    • Shown even for empty categories (with ChillOps message)

Impact

  • "Other" section reduced: 2 additional items now properly categorized (164 → 166 total)
  • Improved clarity: Readers understand what each category contains
  • Better organization: All relevant hardware and tech debt labels properly mapped

Verification

  • ✅ Build passes (TypeScript, lint, build)
  • ✅ January 2026 report regenerated successfully
  • ✅ Category descriptions render correctly in markdown
  • ✅ New labels show proper badge colors
  • ✅ ChillOps messages preserved for empty subsections

Files Changed

  • scripts/lib/label-mapping.mjs - Added 2 labels to categories
  • scripts/lib/markdown-generator.mjs - Added description injection logic
  • reports/2026-01-31-report.mdx - Regenerated with improvements
  • .planning/todos/done/2026-01-28-improve-label-categorization.md - Todo tracking

Related

  • Closes todo: Improve label categorization in monthly reports
  • Follows pattern from translation label commit e568ef8
  • Part of v1.1 monthly reports post-launch improvements

Moved todo to done/, beginning implementation on feature branch.
- Add aarch64 label to Hardware category (ARM64 architecture work)
- Add aarch64 color mapping (F59E0B amber, matches area/hardware)
- Add kind/parity to Tech Debt category (feature parity work)

This reduces items in 'Other' section and improves categorization.
Add italic descriptions below each category header explaining what types
of work fall under each area. Descriptions appear above the Planned/
Opportunistic split and are shown even for empty categories (with
ChillOps message).

Categories with descriptions:
- Desktop: GNOME, Aurora (KDE), terminal enhancements
- Development: Development tools and IDE integrations
- Ecosystem: Homebrew, Bluespeed (AI/ML), Flatpak apps
- System Services & Policies: Systemd and system-level policies
- Hardware: Drivers, NVIDIA GPU, ARM64 architecture
- Infrastructure: ISO, upstream integration, build systems, testing
- Documentation: Documentation improvements
- Tech Debt: Maintenance and feature parity work
- Automation: CI/CD pipelines, GitHub Actions, Renovate
- Localization: Translation and internationalization

Improves reader clarity and helps understand report organization.
Regenerate with new label mappings and category descriptions:
- aarch64 items now in Hardware section (from Other)
- kind/parity items now in Tech Debt section
- All categories show descriptive text
- 2 additional items categorized (was 164, now 166)

This demonstrates the improvements working correctly.
@castrojo castrojo merged commit db601e1 into main Jan 29, 2026
2 checks passed
@castrojo castrojo deleted the feature/improve-label-categorization branch January 29, 2026 01:36
@castrojo castrojo added kind/automation CI/CD workflows, scripts, and automation tooling kind/documentation Improvements or additions to documentation labels Jan 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/automation CI/CD workflows, scripts, and automation tooling kind/documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants