wg icon indicating copy to clipboard operation
wg copied to clipboard

Discussion: What sort of labels do we want to start tracking on issues?

Open Lokathor opened this issue 5 years ago • 2 comments

We've wanted to improve labels on issues, and I've got write powers to slap labels all over now, but we need to talk about what labels we're going to be using.

The default GitHub labels are, I think clearly, not really suitable to a discussion and tracking oriented repository.

Instead, we probably want labels more inspired by larger projects like winit and gfx-hal:

  • Labels for platform specific issues (Windows, Mac, Linux, Android, iOS, stdweb, wasm-pack, etc)
  • Labels for the general broad subjects of what expertise is used to tackled the problem (OS APIs, graphics APIs, sound processing, math and physics, etc)
  • Labels for the complexity of solving the issue (needs RFC, needs PR to rust, needs PR to crate, etc)
  • Labels for severity of the issue being unresolved (major blocker, minor annoyance, wishlist, etc)

Feedback is both requested and required. Does this sound reasonable to others? Am I missing things we'd want to cover? Am I approaching the entire issue in some bad way?

Lokathor avatar Oct 11 '19 02:10 Lokathor

In general, I like you proposal. I tried thinking of the different use cases that I'd use issues for:

If I see an issue, I want to know:

  • Is someone working on it? (assignee)
  • What is the status of the issue? WIP? Pending review? Waiting for feedback? Discuss in WG meeting? Done?
  • Is more help required? (i.e. contributors, feedback)
  • Is the WG responsible for progress on this issue, or are we merely documenting it? If so, who is responsible? (other WG or third parties)
  • Is this something I can contribute to? (complexity / size of task)
  • What's the priority of this issue?

If I want to find an issue, I look for:

  • Keywords (i.e. a descriptive title)
  • What's the progress on this issue? Can I contribute to it? (ties back to the status of the issue)

When preparing discussion topics for a meeting, I want to know:

  • Which open issues need to be discussed?
  • Who can tell more about those issues? (assignee, external WG rep, or third-party rep)
  • Order by priority

I think these largely overlap with what you proposed, but there are some slight differences.

Wodann avatar Oct 14 '19 11:10 Wodann

Well, no one said anything for over a month, so I just kinda started making some labels and putting them on stuff. The issues should be somewhat more approachable now.

We could do more, but that's the update for now.

Lokathor avatar Dec 11 '19 20:12 Lokathor