Skip to content

Fancy links for GH issues representing external reviews #3749

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

Merged
merged 4 commits into from
Apr 1, 2024

Conversation

jyasskin
Copy link
Collaborator

@jyasskin jyasskin commented Mar 27, 2024

For all open issues, this adds the amount of time they've been open:
image

For open position issues, colors the links according to how long they've been open, with thresholds at 2 weeks and 1 month. https://www.chromium.org/blink/launching-features/#new-feature-prepare-to-ship says to give reviewers at least a month to review, so ... @chrishtr @miketaylr what colors do you want for what ages?
image

For resolved position issues, colors the links according to the position:
image

@jyasskin jyasskin requested a review from jrobbins March 27, 2024 19:20
@jyasskin jyasskin force-pushed the external-review-fancy-links branch from 3d2d891 to 7a9b972 Compare March 27, 2024 19:46
Copy link
Collaborator

@jrobbins jrobbins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM after considering one possible change.

if (stateVariant === undefined) {
if (state === 'open') {
const age = Date.now() - createdAt.getTime();
stateDescription = html`Opened <relative-time .date=${createdAt} format="relative" precision="day" threshold="P100Y">on ${_dateTimeFormat.format(createdAt)}</relative-time>`;
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We already have <sl-relative-time> as used in utils.js. Could you use that? It might even just be wrapping the same underlying library.

Copy link
Collaborator Author

@jyasskin jyasskin Mar 27, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<sl-relative-time> is missing the precision argument that I'm using to turn "Opened 2 Hours Ago" into "Opened Today" (once github/relative-time-element#280 goes in), but that's not a big deal if you'd rather avoid the dependency. I'll see if there are any other problems once my development machine finishes upgrading.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have to undo the style from

sl-relative-time {
margin: 0 -3px; // Mitigate spacing from unknown cause.
}

but then it seems to work:
image

Here's a patch without <relative-time>.

@jyasskin jyasskin force-pushed the external-review-fancy-links branch from 7a9b972 to 3a10f32 Compare March 27, 2024 21:18
@miketaylr
Copy link

miketaylr commented Mar 27, 2024

so ... @chrishtr @miketaylr what colors do you want for what ages?

Hmm, this is trickier to consider than I expected! I do see the ~one month guidance for TAG, but not for other vendors, FWIW. I think the colors you have do make sense, once we document them. Red: "probably too soon for a fulsome response", orange: "proceed with caution" and gray/black: "YOLO 💀". Did I get that right?

For resolved position issues, colors the links according to the position:

This looks great.

@jyasskin
Copy link
Collaborator Author

jyasskin commented Mar 28, 2024

@miketaylr That's about right. I'd s/YOLO/the API owners have to make a call/ though. ;) https://www.chromium.org/blink/launching-features/#new-feature-prepare-to-ship now asks for 1 month for vendors too.

@chrishtr
Copy link
Collaborator

https://www.chromium.org/blink/launching-features/#new-feature-prepare-to-ship now asks for 1 month for vendors too.

It isn't up to us how long other vendors or the TAG take to respond though. Is this meant to represent whether the issue itself is overdue, or something whether a feature owner should consider it "timed out"?

@jyasskin
Copy link
Collaborator Author

It's more about whether the external reviewer has clearly not had enough time to review it. The color here only goes to neutral gray after a month and not green because I don't think there's any automated way to decide whether the review has timed out. That's up to the human reviewers.

@miketaylr
Copy link

It isn't up to us how long other vendors or the TAG take to respond though.

Correct. But I think guidance to ask early enough to improve the odds of getting a response is good. And then API OWNERs can make a call (as we sometimes do "let's give it a week or two to bake and hope for a response", etc.)

@chrishtr
Copy link
Collaborator

Ok makes aense. How about yellow for less than 1 months, meaning "in progress, shipping might block on it"? And after that gray.

@jyasskin
Copy link
Collaborator Author

Works for me. I'll make that change Monday.

@jyasskin jyasskin force-pushed the external-review-fancy-links branch from 0142e78 to 3d573d2 Compare April 1, 2024 16:26
@jyasskin
Copy link
Collaborator Author

jyasskin commented Apr 1, 2024

Ok, everything less than a month (actually 4 weeks) is now yellow. I'll merge in a couple hours unless I hear concerns. Thanks!

@jyasskin jyasskin merged commit 9d0786f into GoogleChrome:main Apr 1, 2024
@jyasskin jyasskin deleted the external-review-fancy-links branch April 1, 2024 21:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants