Skip to content

Make artifact verification instructions more visible #2463

Closed

Description

@sethmlarson

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.

Activity

  1. JacobCoffee commented on Sep 13, 2024

    @JacobCoffee
    Member

    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 :(

  2. added
    frontendRelates to the frontend of the app
    backendRelates to the backend of the app
    adminRelates to Django Admin
    app/downloadsRelates to the downloads app
    on Sep 13, 2024
  3. sethmlarson commented on Sep 13, 2024

    @sethmlarson
    ContributorAuthor

    @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

  4. edmorley commented on Sep 30, 2025

    @edmorley

    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:

  5. hugovk commented on Sep 30, 2025

    @hugovk
    Member

    Yes, header links were added in #2247 and #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 #2783.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    adminRelates to Django Adminapp/downloadsRelates to the downloads appbackendRelates to the backend of the appfrontendRelates to the frontend of the app

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions