pythondotorg icon indicating copy to clipboard operation
pythondotorg copied to clipboard

Make artifact verification instructions more visible

Open sethmlarson opened this issue 1 year ago • 2 comments

Today our download pages allude to being able to verify artifacts, either through Sigstore (recommended) or GPG, however these instructions aren't as clearly documented as they could be and in theory we want everyone downloading from python.org to be taking advantage of one of these two options.

My proposal is to:

  • Add an anchor to the download details page for GPG identities so it can be linked to directly.
  • For all download detail pages:
    • Provide a link to the instructions for verifying with GPG
    • If there are Sigstore artifacts, also provide links to instructions for verifying Sigstore.
    • Recommend users using Sigstore over GPG when it's available.

sethmlarson avatar Jun 17 '24 21:06 sethmlarson

all download detail pages

This would be a heavy lift if I understand correctly as each release page is non-codified markdown in the /admin backend :(

JacobCoffee avatar Sep 13 '24 18:09 JacobCoffee

@JacobCoffee We might be able to slot in the information programmatically in this template? https://github.com/python/pythondotorg/blob/main/templates/downloads/release_detail.html#L42

sethmlarson avatar Sep 13 '24 19:09 sethmlarson

This appears to be resolved now?

eg if I visit https://www.python.org/downloads/release/python-3137/ and scroll down to the Files table, the headings for the "Sigstore" and "GPG" columns link to the relevant docs:

  • https://www.python.org/download/sigstore/
  • https://www.python.org/downloads/#gpg

edmorley avatar Sep 30 '25 09:09 edmorley

Yes, header links were added in https://github.com/python/pythondotorg/pull/2247 and https://github.com/python/pythondotorg/pull/2772.

  • Recommend users using Sigstore over GPG when it's available.

We can do something extra for this, and move the GPG column after Sigstore and SBOM. Currently:

Image

Please see PR https://github.com/python/pythondotorg/pull/2783.

hugovk avatar Sep 30 '25 10:09 hugovk