Thank you for opening your first PR into Matplotlib!

If you have not heard from us in a week or so, please leave a new comment below and that should bring it to our attention. Most of our reviewers are volunteers and sometimes things fall through the cracks. We also ask that you please finish addressing any review comments on this PR and wait for it to be merged (or closed) before opening a new one, as it can be a valuable learning experience to go through the review process.

You can also join us on gitter for real-time discussion.

For details on testing, writing docs, and our review process, please see the developer guide.
Please let us know if (and how) you use AI, it will help us give you better feedback on your PR.

We strive to be a welcoming and open project. Please follow our Code of Conduct.

Can you just set the path to the svg produced by the PR? Or if you're gonna use a screenshot, can it somehow highlight the URL part since that's what's important about this example?

Can you just set the path to the svg produced by the PR? Or if you're gonna use a screenshot, can it somehow highlight the URL part since that's what's important about this example?

I set sphinx_gallery_thumbnail_path to a committed SVG (doc/_static/hyperlinks_thumbnail.svg) generated from the example output. Since this example is _sgskip, build-time scatter.svg is not guaranteed to exist, so referencing a checked-in SVG is more reliable. I can also provide an annotated screenshot if preferred, but I used the generated SVG to stay closest to the example output.

Since this example is _sgskip

Does it have to be sgskip if it's given a manual thumbnail path?

Yes, it still needs to be _sgskip regardless of the manual thumbnail path. The _sgskip suffix tells sphinx-gallery to skip executing the script during the docs build — this is necessary because the example saves output directly to disk (scatter.svg, image.svg) using the SVG backend, which sphinx-gallery cannot capture automatically. The sphinx_gallery_thumbnail_path directive only controls which image is used as the gallery thumbnail; it has no effect on whether the script is executed. So even with a manual thumbnail, the execution-related reasons for skipping remain.

The _sgskip suffix tells sphinx-gallery to skip executing the script during the docs build — this is necessary because the example saves output directly to disk (scatter.svg, image.svg)

Why is this necessary? Why does sphinx-gallery care if this is skipped? What happens if you don't skip this?