GitHub labels

[Philippe Le Hégaret]

I took an action item from the web platform wg to provide
recommendations for GitHub labels, with the goal of harmonizing them
across repositories overtime.

Here is what I came up with:
https://w3c.github.io/spec-labels.html

This page is referenced from
https://w3c.github.io/specs.html

Comments, feedback are welcome.

Philippe

[Tab Atkins Jr.]

I took an action item from the web platform wg to provide recommendations
for GitHub labels, with the goal of harmonizing them across repositories
overtime.
https://w3c.github.io/spec-labels.html
This page is referenced from
https://w3c.github.io/specs.html
Comments, feedback are welcome.

Looks reasonable overall.

In CSS we also have a collection of labels used for DoC tracking, with
colors matching the expectations of DoC formatting. You can see them
at https://github.com/w3c/csswg-drafts/labels (they all, conveniently,
start with the letter C, so they're grouped right at the top of the
list).

~TJ

[Sandro Hawke]

When I went through this exercise, there got a lot of pressure from the
group not to have too many labels, so we eventually trimmed it down to 9.

https://github.com/sandhawke/spec-labels-min/labels?sort=name-asc

Since then, we've started using some horizontal review labels, as needed.

Philippe, I could probably dig out the arguments we found persuasive for
these over yours, where they differ, if you want. Mostly it was things
like like WG members not being clear what they meant.

The README for my repo above includes instructions for installing all
the labels. I suppose I should update the source-repo to include the
horizontals.

- Sandro

Post by Tab Atkins Jr.

I took an action item from the web platform wg to provide recommendations
for GitHub labels, with the goal of harmonizing them across repositories
overtime.
https://w3c.github.io/spec-labels.html
This page is referenced from
https://w3c.github.io/specs.html
Comments, feedback are welcome.

Looks reasonable overall.
In CSS we also have a collection of labels used for DoC tracking, with
colors matching the expectations of DoC formatting. You can see them
at https://github.com/w3c/csswg-drafts/labels (they all, conveniently,
start with the letter C, so they're grouped right at the top of the
list).
~TJ

[Philippe Le Hégaret]

Post by Sandro Hawke
When I went through this exercise, there got a lot of pressure from the
group not to have too many labels, so we eventually trimmed it down to 9.
https://github.com/sandhawke/spec-labels-min/labels?sort=name-asc
Since then, we've started using some horizontal review labels, as needed.
Philippe, I could probably dig out the arguments we found persuasive for
these over yours, where they differ, if you want. Mostly it was things
like like WG members not being clear what they meant.

Yours kind of embed their semantic in the label name, which makes same
long. I'd be curious to know if others find it more useful. Can you
raise an issue on GitHub in the meantime so that we don't loose track of
this?

Post by Sandro Hawke
The README for my repo above includes instructions for installing all
the labels. I suppose I should update the source-repo to include the
horizontals.

Sure. The hope here is to facilitate the work of folks doing horizontal
reviews.

Philippe

[Tobie Langel]

Post by Philippe Le Hégaret
I took an action item from the web platform wg to provide
recommendations for GitHub labels, with the goal of harmonizing them
across repositories overtime.
https://w3c.github.io/spec-labels.html

Overall, these look good. It would be nice to have a bit more
consistency (sometimes you;re using ":" as a namespace, sometimes, using
spaces, sometimes dashes). I'd also recommend avoiding whitespace, which
makes searching more complicated (you have to quote labels) and URLs
less user friendly (%20 everywhere), but that's a minor issue.

--tobie

[Philippe Le Hégaret]

Post by Tobie Langel

Post by Philippe Le Hégaret
I took an action item from the web platform wg to provide
recommendations for GitHub labels, with the goal of harmonizing them
across repositories overtime.
https://w3c.github.io/spec-labels.html

Overall, these look good. It would be nice to have a bit more
consistency (sometimes you;re using ":" as a namespace, sometimes, using
spaces, sometimes dashes). I'd also recommend avoiding whitespace, which
makes searching more complicated (you have to quote labels) and URLs
less user friendly (%20 everywhere), but that's a minor issue.

Thanks Tobie. Good points. I'll revise the labels with this mind.

Philippe