New Supply Chain Problems section #1544
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
I sent Tom a note outlining my ideas on why this section has changed. I've been working hard to find ways to smooth the logic flow, increase clarity, and add organization to the complication of all these different SLSA topic pages and sections. It's difficult for a new reader to navigate through the ideas because there are duplications, omissions, and different styles of organizing information by the contributors. As I was seeing the final pieces come together, I noticed more problems but I came up with some new ideas at the last minutes. I'd like to try and group the pages into three content categories that are basically consists of:
This PR combined the threat pages together into a TOC category I'd like to call the Supply Chain Threat Problem. Next I'd like to combine all the SLSA Technical pages into a TOC category I'd like to call The SLSA Solution. These simplified categories will make it easier for new user to navigate through all these complicated ideas.
Here's my thoughts on how a new TOC would look:
INTRODUCTION TO SLSA
What is SLSA?
Applying SLSA
Use Cases
Guiding Principles
Terminology
About this Document
What's New?
THE SUPPLY CHAIN PROBLEM
Introduction to Supply Chain Threats
with the Real World Supply Chain Examples table
Threats & Mitigations
more?
THE SLSA SOLUTION
Build Track
Build Track: Basics
Build Track: Requirements for producing artifacts
Build Track: Distributing provenance
Build Track: Verifying artifacts
Build Track: Assessing build platforms
Build Environment Track
Build Environment Track: Basics
Dependency Track
Dependency Track: Consuming dependencies
Source Track
Source Track: Consuming source
Source Track: Verifying source
Source Track: Assessing source control systems
Source Track: Example controls
Attestation Formats
Attestation formats: General model
Attestation formats: Provenance
Attestation formats: Build Provenance
Attestation formats: Verification Summary Attestation (VSA)
Verified properties
RESOURCES
FAQ
Specification stages
Future directions
Blog
Community
Contributor guide?
More
Files include:
real-world-examples.md - Introduces the Supply Chain Problem section, including intro and real world examples.
threats.md - Threats & Mitigations section that was under Cross Track Information.
DO NOT MERGE