New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document how we work with GitHub labels #808

Open
honzajavorek opened this Issue Jun 20, 2017 · 2 comments

Comments

Projects
None yet
2 participants
@honzajavorek
Copy link
Member

honzajavorek commented Jun 20, 2017

  • in progress is meant for PRs which are open, but should not be reviewed yet nor merged
  • Except for in progress we usually do not attach any labels to PRs
  • bug is meant for issues about bugs
  • flaky test is meant for issues about flaky tests, the severity is equal to bug
  • low hanging fruit ...

etc. should go to contributing docs.

@kylef

This comment has been minimized.

Copy link
Member

kylef commented Aug 25, 2017

I'd like to sync on this so we can have consistency across our OSS in ADT too.

@honzajavorek

This comment has been minimized.

Copy link
Member

honzajavorek commented Aug 28, 2017

Except for what I described above there's:

  • behavior change, which should probably mark breaking changes, but I don't presonally use it much.
  • I use duplicate to mark duplicate issues before closing them, so if someone finds them, they can immediately see it's closed because there's equivalent issue, not because it's fixed.
  • There's security issue, which I used to mark vulnerabilities. Should be probably named vulnerability instead, to be consistent with terms used by Snyk.
  • I'm not sure how much improvement label is useful, because basically anything else then bug is improvement or discussion/question.
  • I don't mark discussion/question, I just try to answer and close the issue ASAP if the OP is satisfied with the outcome or when they won't come back.
  • low hanging fruit is something we use for issues we identified with @netmilk as small tasks anyone can easily come and do. I think they could work as good tasks for first time contribution or as something maintainers choose to work on when they're out of stories in the sprint. Or when they're bored in train.
  • I thought of a label which would indicate I'm willing to coach someone to deliver an issue. But I'm willing to coach anyone on any issues, so this is probably equivalent to the one above.
  • There are Epic: something labels in golden color (I was corrected by @netmilk it's gold, not dirty yellow). Dredd has several big areas which need significant attention and which are root causes for many issues. We call them epics and treat them as epics in our sprints. Some are just tidying up (make sure we work correctly with URI parameters), some are product development (rethinking of transaction names).
  • There are Context: something labels, which help us identify issues related to a specific dependency, operating system, API description format, etc. Those are useful for basic orientation in context of the issues and ideally, ADT could actually watch issues having certain contexts. But there's not so many of such issues at the moment, so I'm okay with mentioning you explicitly. Looking at current context labels I personally think JS hooks should be actually an epic.

BTW I don't keep the same labels elsewhere then in the Dredd repo, which is maybe a shame...

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