Skip to content

Comments

editorial: draft: Move example controls to its own page.#1503

Merged
TomHennen merged 14 commits intoslsa-framework:mainfrom
TomHennen:fix1465
Oct 27, 2025
Merged

editorial: draft: Move example controls to its own page.#1503
TomHennen merged 14 commits intoslsa-framework:mainfrom
TomHennen:fix1465

Conversation

@TomHennen
Copy link
Contributor

@TomHennen TomHennen commented Oct 23, 2025

Move the example controls from source-requirements.md to their own page and improve their formatting.

These examples were never meant to be a part of the spec itself but rather as example controls that others may want to implement or that would serve as inspiration for developing their own controls. They go above and beyond the specific requirements of the source track itself.

This change:

  1. Moves the content to its own page, adding links to the nav bar and tracks.md page.
  2. Improves the formatting of the content, making summary, intended for, and benefits a table to make it easier to parse.
  3. Fills in some gaps that existed: one section didn't have a summary, etc, another was missing the 'intended for' information.
  4. Updated the introduction so that it doesn't reference SLSA L4. These examples can be used as a part of L4 but they don't need to be (e.g. the testing or merge train examples).

Points 3 and 4 required changing this to an 'editorial' fix instead of a 'style' fix.

fixes #1465

Moving this existing content with as few changes as possible.

This content was never meant to be part of the spec but just
inspirtation for folks implementing controls for themselves.

refs slsa-framework#1465

Signed-off-by: Tom Hennen <tomhennen@google.com>
@netlify
Copy link

netlify bot commented Oct 23, 2025

Deploy Preview for slsa ready!

Name Link
🔨 Latest commit 57b1aff
🔍 Latest deploy log https://app.netlify.com/projects/slsa/deploys/68fa641f9db9ba00078922f2
😎 Deploy Preview https://deploy-preview-1503--slsa.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
Signed-off-by: Tom Hennen <tomhennen@google.com>
@TomHennen TomHennen changed the title style: Move example controls to its own page. editorial: Move example controls to its own page. Oct 23, 2025
@TomHennen TomHennen requested a review from arewm October 23, 2025 17:27
@TomHennen TomHennen added source-track slsa 1.2 Required for SLSA 1.2 release. Please apply it liberally! labels Oct 23, 2025
@arewm
Copy link
Member

arewm commented Oct 27, 2025

nit: is this a draft: editorial: change instead of a pure editorial?

@TomHennen
Copy link
Contributor Author

nit: is this a draft: editorial: change instead of a pure editorial?

technically 'editorial: draft:', but yes, let me fix it. :)

@TomHennen TomHennen changed the title editorial: Move example controls to its own page. editorial: draft: Move example controls to its own page. Oct 27, 2025
@TomHennen TomHennen merged commit 8b0ccfe into slsa-framework:main Oct 27, 2025
9 checks passed
@github-project-automation github-project-automation bot moved this from 🆕 New to ✅ Done in Issue triage Oct 27, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

slsa 1.2 Required for SLSA 1.2 release. Please apply it liberally! source-track

Projects

Status: Done
Status: Done

Development

Successfully merging this pull request may close these issues.

Making (sub-sub-)section structured information more visible

3 participants