Skip to content
This repository was archived by the owner on Nov 18, 2021. It is now read-only.
This repository was archived by the owner on Nov 18, 2021. It is now read-only.

[meta] clean up and document labels in this issue tracker #1549

Open

Description

@aspiers

As mentioned by @TPS in #1472, this issue tracker has almost 100 labels without any clear strategy or documentation for how to use them.

We should add a policy document (e.g. labels.md) to the repo which addresses this, and then anyone can submit PRs suggesting changes.

Activity

  1. changed the title [-]clean up and document labels in this issue tracker[/-] [+][meta] clean up and document labels in this issue tracker[/+] on Apr 23, 2019
  2. TPS commented on Apr 28, 2019

    @TPS
    Collaborator

    There are some names I’ve used like render which are internal to GitHub and need explanation to have meaning. I want the labels to be obvious and useful internally and externally.

    @clarkbw Did you want to handle the internal/external consistency yourself (b/c AFAIK you're the only GitHub staff who's also a collaborator here)? Else, if you gave some guidelines/docs, I'd happily help w/ that.

  3. TPS commented on May 5, 2019

    @TPS
    Collaborator

    To perhaps start this, I'd like to meekly quote myself:

    my rule-of-thumb is try to use label combinations that best express what the issue's about

    somewhat independent of what else might be labeled such. Most of the time, related issues do end up grouped, but, sometimes, issues only conceptually similar do end up w/ the same label. #1547 (comment) makes a great example of this.

    I think in a typical repo, this would be acceptable, & projects would be used to group more tightly-related issues, milestones grouping projects, &c. Here, how do we want to do it?

  4. clarkbw commented on May 9, 2019

    @clarkbw
    Collaborator

    I've made some progress so far on a first pass, will keep updating this as I go.

    label description
    accessibility A11y related issues with GitHub interfaces
    API Requests related to the GitHub developer API
    archive Archived or archiving repository interactions
    authentication SMS, 2FA, MFA, WebAuthn, passwords, and other related authentication schemes
    automation Reducing manual interactions and increasing productivity through automated processes
    bug 🐛
    pull-requests Anything to do with PRs https://github.com/isaacs/github/pulls
  5. TPS commented on May 17, 2019

    @TPS
    Collaborator

    Does anyone mind if I emojify a few more labels, since @clarkbw has now set a (perhaps dangerous 😉) precedent w/ the update to the bug 🐛 label? Or should that be kept special?

  6. clarkbw commented on May 17, 2019

    @clarkbw
    Collaborator
  7. TPS commented on May 17, 2019

    @TPS
    Collaborator

    1 concern: existing manual links to these break whenever renaming labels (which includes adding emoji, naturally — it's why I edited a couple of our posts above). The UI links by GitHub rendering update fine, though. Is that important enough to keep from messing too much w/ these on a wholesale basis?

    AFAIK, GitLab's ~<label> syntax solves this pretty neatly.

  8. captn3m0 commented on May 23, 2019

    @captn3m0

    -1 for Emojis in labels: #1580

  9. TPS commented on May 24, 2019

    @TPS
    Collaborator

    @cirosantilli Well, since I invited comment here, why's the separate issue needed? But you do make a good point. 🙇🏾‍♂️

  10. cirosantilli commented on May 24, 2019

    @cirosantilli
    Collaborator

    I removed the bug emoji now since people seem to agree #1580

  11. aspiers commented on Jul 18, 2019

    @aspiers
    CollaboratorAuthor

    Thanks everyone for your contributions here! Can I suggest that we move this list of labels into a new file in the repo (e.g. LABELS.md or something like that)? That way anyone can submit PRs making the list better, and also it makes it more visible to end users.

  12. TPS commented on Aug 14, 2019

    @TPS
    Collaborator

    Dunno if this rates a separated Meta issue: Would GitHub Actions be helpful in automatically applying these? That Labeler template seems mighty inviting.… except it's for PRs.…

  13. TPS commented on Sep 2, 2019

    @TPS
    Collaborator

    There's now the Issue Label Bot.… Whaddy'all think re: letting it loose here⁈

  14. TPS commented on Dec 21, 2019

    @TPS
    Collaborator

    The equivalent GitHub Action as Labeler, but for issues, seems to be tag-ur-it. (FWIW, it's been further developed by a GitHub ex-staffer.)

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions