Skip to content

chore: create new label taxonomy and remove old labels #691

Closed

Description

@andreahlert

Part of #690

Create the 40 labels defined in the umbrella issue and delete the 27 old labels they replace. This should be done in a single pass to avoid confusion.

Steps

  1. Create all kind/*, area/*, priority/*, status/*, pr/*, lifecycle/* labels with correct colors
  2. Rename release-issues → release, gsoc2026 → gsoc
  3. Delete old labels after migration is complete (sub-issues 2 and 3)

Labels to create (40)

kind/: kind/bug, kind/feature, kind/improvement, kind/documentation, kind/cleanup, kind/question, kind/umbrella

area/: area/core, area/ui, area/storage, area/streaming, area/hooks, area/tracking, area/integrations, area/visualization, area/website, area/ci, area/examples, area/typing

priority/: priority/critical, priority/high, priority/medium, priority/low

status/: status/needs-triage, status/needs-info, status/accepted, status/blocked, status/wontfix

pr/: pr/do-not-merge, pr/ready-to-merge, pr/needs-rebase, pr/stale

lifecycle/: lifecycle/stale, lifecycle/frozen

special: breaking-change, gsoc (rename), release (rename), hacktoberfest (keep)

Labels to delete (27)

invalid, duplicate, launch, exploratory, product direction, design decision, hamilton, AWS, gsoc2026, javascript, release-issues, exceptions, triage, bug, documentation, enhancement, question, wontfix, repo hygiene, parallelism, visibility, ui, storage, integrations, visualization, hooks, examples, umbrella

Note: Labels must be migrated on existing issues/PRs before deletion (see #690 sub-issues 2 and 3).

Activity

  1. self-assigned this
    on Mar 25, 2026
  2. andreahlert commented on Mar 28, 2026

    @andreahlert
    CollaboratorAuthor

    @skrawcz here's the script to create the labels. Needs write access to run (gh CLI authenticated).

    #!/usr/bin/env bash
    REPO="apache/burr"
    
    # kind/*
    gh label create "kind/bug" --repo $REPO --color "d73a4a" --description "Something is broken" --force
    gh label create "kind/feature" --repo $REPO --color "a2eeef" --description "Net-new functionality" --force
    gh label create "kind/improvement" --repo $REPO --color "7fd4f2" --description "Improving something that already exists" --force
    gh label create "kind/documentation" --repo $REPO --color "0075ca" --description "Docs, examples, notebooks" --force
    gh label create "kind/cleanup" --repo $REPO --color "e6e6e6" --description "Refactor, typos, tech debt" --force
    gh label create "kind/question" --repo $REPO --color "d876e3" --description "Usage questions" --force
    gh label create "kind/umbrella" --repo $REPO --color "50645A" --description "Tracking issue grouping sub-issues" --force
    
    # area/*
    gh label create "area/core" --repo $REPO --color "1a5276" --description "Application, State, Graph, Actions" --force
    gh label create "area/ui" --repo $REPO --color "1B2B4A" --description "Burr UI (telemetry frontend)" --force
    gh label create "area/storage" --repo $REPO --color "AB74C0" --description "Persisters, state storage" --force
    gh label create "area/streaming" --repo $REPO --color "29C8CA" --description "Streaming actions, parallel streams" --force
    gh label create "area/hooks" --repo $REPO --color "D17E0D" --description "Lifecycle hooks, interceptors" --force
    gh label create "area/tracking" --repo $REPO --color "9ECD0C" --description "Telemetry, tracing, OpenTelemetry" --force
    gh label create "area/integrations" --repo $REPO --color "EA1850" --description "External integrations (LLMs, frameworks)" --force
    gh label create "area/visualization" --repo $REPO --color "0052cc" --description "Graph visualization, diagrams" --force
    gh label create "area/website" --repo $REPO --color "6f42c1" --description "burr.apache.org website" --force
    gh label create "area/ci" --repo $REPO --color "bfd4f2" --description "Workflows, build, release scripts" --force
    gh label create "area/examples" --repo $REPO --color "EFFAAD" --description "Relates to /examples" --force
    gh label create "area/typing" --repo $REPO --color "c5def5" --description "Mypy, type hints, pydantic" --force
    
    # priority/*
    gh label create "priority/critical" --repo $REPO --color "b60205" --description "Blocks release or breaks core functionality" --force
    gh label create "priority/high" --repo $REPO --color "d93f0b" --description "Affects many users, needs action within weeks" --force
    gh label create "priority/medium" --repo $REPO --color "fbca04" --description "Important but not urgent" --force
    gh label create "priority/low" --repo $REPO --color "0e8a16" --description "Nice-to-have, backlog" --force
    
    # status/*
    gh label create "status/needs-triage" --repo $REPO --color "BBEC04" --description "New issue, needs triage" --force
    gh label create "status/needs-info" --repo $REPO --color "f9d0c4" --description "Waiting on author response" --force
    gh label create "status/accepted" --repo $REPO --color "0e8a16" --description "Triaged, validated, ready to work on" --force
    gh label create "status/blocked" --repo $REPO --color "b60205" --description "Depends on another issue/PR/decision" --force
    gh label create "status/wontfix" --repo $REPO --color "ffffff" --description "Decided not to fix" --force
    
    # pr/*
    gh label create "pr/do-not-merge" --repo $REPO --color "b60205" --description "Blocks merge, needs more work" --force
    gh label create "pr/ready-to-merge" --repo $REPO --color "0e8a16" --description "Reviewed, CI green, good to go" --force
    gh label create "pr/needs-rebase" --repo $REPO --color "fbca04" --description "Conflicts with main" --force
    gh label create "pr/stale" --repo $REPO --color "e6e6e6" --description "No activity for 14+ days after review" --force
    
    # lifecycle/*
    gh label create "lifecycle/stale" --repo $REPO --color "e6e6e6" --description "No activity for 90 days" --force
    gh label create "lifecycle/frozen" --repo $REPO --color "d4c5f9" --description "Protected from auto-close (roadmap, umbrellas)" --force
    
    # special
    gh label create "breaking-change" --repo $REPO --color "d73a4a" --description "PR that breaks backward compatibility" --force
    
    # renames
    gh label edit "release-issues" --repo $REPO --name "release" --description "Release-related issues"
    gh label edit "gsoc2026" --repo $REPO --name "gsoc" --description "Google Summer of Code"
    
    echo "Done! 40 labels created + 2 renamed."

    After this I can handle the migration to the new labels myself with triage access (#692, #693).

  3. skrawcz commented on Mar 28, 2026

    @skrawcz
    Contributor

    done.

  4. andreahlert commented on Mar 28, 2026

    @andreahlert
    CollaboratorAuthor

    Labels migrated to new taxonomy (#692).

  5. andreahlert commented on Mar 30, 2026

    @andreahlert
    CollaboratorAuthor

    @skrawcz here's the script to delete the legacy labels. Same deal, needs write access.

    All issues and PRs have already been migrated to the new taxonomy (#692, #693), so these labels are now unused.

    #!/usr/bin/env bash
    REPO="apache/burr"
    
    labels=(
      "invalid"
      "duplicate"
      "launch"
      "exploratory"
      "product direction"
      "design decision"
      "hamilton"
      "AWS"
      "javascript"
      "release-issues"
      "exceptions"
      "triage"
      "bug"
      "documentation"
      "enhancement"
      "question"
      "wontfix"
      "repo hygiene"
      "parallelism"
      "visibility"
      "ui"
      "storage"
      "integrations"
      "visualization"
      "hooks"
      "examples"
      "umbrella"
    )
    
    for label in "${labels[@]}"; do
      echo "Deleting: $label"
      gh label delete "$label" --repo "$REPO" --yes
    done
    
    echo "Done! ${#labels[@]} legacy labels deleted."
  6. andreahlert commented on Mar 30, 2026

    @andreahlert
    CollaboratorAuthor

    All new labels created, legacy labels deleted by @skrawcz. Done.

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

Metadata

Metadata

Labels

area/ciWorkflows, build, release scriptskind/cleanupRefactor, typos, tech debtpriority/mediumImportant but not urgent

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions