Present metric details differently?

[robdodson]

Feature request summary It might be nice if the individual metrics in the metrics table linked to their corresponding docs in web.dev/metrics.

What is the motivation or use case for changing this? If you're unfamiliar with the metrics you may not know to go check web.dev for their explainers.

How is this beneficial to Lighthouse? It'll help people grok what the metrics table means.

[patrickhulce]

Thanks for filing Rob! :)

Two honest questions:

1. As a user, what would you expect the blue/gray pill on the right side of the screenshot does?
2. Would you have tried to click on it in your normal usage without these question prompts?

Reveal this after answering :)

I suspect that no one knows what it does and/or never tries to click on it to expand to see the descriptions and links. Any ideas for how to make that more obvious? Maybe if the pill were replaced with a `?` or `info` icon or something that could be toggled? Making the metric names clickable themselves to the same docs link is a nice idea too 👍

[robdodson]

As a user, what would you expect the blue/gray pill on the right side of the screenshot does?

Good question. My brain just thinks "makes report longer" but I never click on that button.

Would you have tried to click on it in your normal usage without these question prompts?

Nope

Maybe if the pill were replaced with a ? or info icon or something that could be toggled?

I'd suggest putting a little question mark or i within a circle as close to the metric text as possible. IOW: First Contentful Paint ⓘ

[brendankenny]

As @patrickhulce notes, there are links, but they're with the descriptions and hidden by default. This should probably roll up into any iteration we do on how we show the metrics, but I'm not sure if we have a bug tracking that right now.

[paulirish]

Let's bring this back to the designers.