Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

OSPS-DO-03.01 checks for a support file, but the requirement is release verification instructions

Ouverte
#511 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
48/100
Type d'issue
Bug
Clarté
Plutôt claire
Activité
Active
Stack technique
python

Piste de recherche

Start by reading the SupportDocumentation control in openssf-baseline.toml, then trace where that control is implemented and tested. Check how the project represents documentation checks and whether it can determine if a release exists. Done means the check assesses release-integrity instructions in project documentation, cannot pass on keywords alone, and is not assessed when there are no releases.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

module-baseline

OSPS-DO-03.01 (Maturity Level 3) reads:

When the project has made a release, the project documentation MUST contain instructions to verify the integrity and authenticity of the release assets.

The control is named SupportDocumentation in openssf-baseline.toml and checks for a support file (file_exists) followed by a keyword regex for support|help|issue|question. Neither measures the requirement: a SUPPORT.md passes, and a project that documents signature or checksum verification in its README or release notes does not.

Suggested direction:

  • rename the control and replace the steps with ones aimed at the requirement (look for verification instructions in the README, release docs, or SECURITY.md: cosign/gpg/sha256sum/slsa-verifier usage);
  • keep any keyword step unable to conclude PASS; the final say belongs to a judgment of the documentation content;
  • the requirement is conditional on a release existing, so the control should be N/A (or not assessed) when there are no releases.

Related: #508 (another control whose check does not match its requirement).

Langage dominant
Python
Étoiles
22
Forks
27
Merge moyen
1 j 20 h
PR mergées (30 j)
39

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de darnitdevorg/darnit

Toutes les issues de darnitdevorg/darnit

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.