Skip to content

[docs-scanner] Broken cross-reference to slsa-definitions.md #24662

@docker-agent

Description

@docker-agent

File: content/manuals/build/metadata/attestations/slsa-provenance.md

Issue

The page references a non-existent file twice:

Line 24:

For more information about how BuildKit populates these provenance properties, refer to
SLSA definitions.

Line 171:

difference between SLSA v0.2 and v1 provenance attestations, refer to
SLSA definitions

The file slsa-definitions.md does not exist in the content/manuals/build/metadata/attestations/ directory or anywhere else in the repository.

Why this matters

Readers who want to understand how BuildKit populates provenance properties or the differences between SLSA versions will click these links and encounter 404 errors. This is particularly problematic because the page explicitly directs readers to this resource for important technical details.

Suggested fix

Either:

  1. Create the missing slsa-definitions.md file with the SLSA definitions and version comparison information, or
  2. Link to the official SLSA specification documentation instead, or
  3. Incorporate the essential information directly into the provenance page and remove these references

Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions