[erinxocon]

Astro assumes images can fill the viewport, but Starlight caps the content column at 47rem, so browsers picked oversized srcset candidates. Set sizes to the real max display width.

[jacobgkau]

This is (obviously) lowering the quality of images displayed on the page. Since we're capping the resolution at the displayed size, the PR description makes it sound like we're simply capping the quality level at what it should be at the displayed size, but the quality difference is perceptible at 100% for some images. Additionally, the quality difference becomes more apparent as soon as you start zooming into the webpage.

So, a couple of questions:

• Could we calculate twice the size of the max width instead of only the max width? This would provide wiggle room for zooming in (which is very casual to do these days with pinch-to-zoom, and is also an accessibility consideration). It would still be a decrease in size from the current miscalculation, so it would still be a bandwidth reduction for us.
• If you're not on-board with that approach, what is the AVIF quality level (% or CRF) these resized images are being rendered at, and do we have any control over it? For reference, I use 60% quality for the full-size AVIF images, but in photo/video rendering, it's common to need to increase the quality level as the resolution is decreased (because as resolution decreases, you have less extraneous detail that you could drop).