Skip to content
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

Outdated labels table #24149

Closed
dawei-wang opened this issue Feb 3, 2023 · 2 comments · Fixed by #24182
Closed

Outdated labels table #24149

dawei-wang opened this issue Feb 3, 2023 · 2 comments · Fixed by #24182
Labels
Content:Meta Content in the meta docs

Comments

@dawei-wang
Copy link
Contributor

dawei-wang commented Feb 3, 2023

MDN URL

https://developer.mozilla.org/en-US/docs/MDN/Community/MDN_content

What specific section or headline is this issue about?

What we need help with

What information was incorrect, unhelpful, or incomplete?

The table links lead to issue labels that are blank.

What did you expect to see?

I expected to see an updated table and text introducing the table.

Do you have any supporting links, references, or citations?

https://github.com/mdn/content/issues?q=is%3Aissue+is%3Aopen+label%3A%22time%3A+-30mins%22
https://github.com/mdn/content/issues?q=is%3Aissue+is%3Aopen+label%3A%22time%3A+-3hr%22
https://github.com/mdn/content/issues?q=is%3Aissue+is%3Aopen+label%3A%22time%3A+-2days%22

Do you have anything more you want to share?

FWIW , I like the time-based labeling scheme because it helped me manage my time. Small, medium, and large effort are harder to quantify. I would like to know the reasoning behind changing the labels.

MDN metadata

Page report details
@dawei-wang dawei-wang added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Feb 3, 2023
@Josh-Cena
Copy link
Member

I would like to know the reasoning behind changing the labels.

Here's some relevant conversation:

Florian Scholz: I know GitHub labels are being work on, I'm just here to say that labels like "https://github.com/mdn/content/labels/time%3A%20-30mins" with the tooltip "Less than 30 mins. A quick task." are not encouraging 😄 30 minutes for whom?! More like 300 minutes for me to read into the details of this one, for example #4713

Brian Smith: Totally agree, I think the original purpose of these was for contributors to gauge how much time they would need to fix something. We might move to something more generic like

effort: small - Task is a small effort.
effort: medium - Task is a medium effort.
effort: large - Task is large effort.

Florian Scholz: That looks much better. I mean sometimes changing one sentence can take 2 hours whereas creating a new page can be like 20 minutes if you know the subject well etc.

FWIW, these labels are kind of arbitrarily assigned anyway, and there isn't a fixed metric about what's a small vs. medium task. It could well turn out that a seemingly small task would need to involve tens of pages to be fixed properly.

@dawei-wang
Copy link
Contributor Author

Thanks for the insight @Josh-Cena. I'll go ahead and change the links to reflect the small, medium, and large effort labels. It doesn't help our readers much if links lead to blank pages.

dawei-wang added a commit to dawei-wang/content that referenced this issue Feb 5, 2023
@Josh-Cena Josh-Cena added Content:Meta Content in the meta docs and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Feb 5, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:Meta Content in the meta docs
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants