Skip to content

docs: add sample fixture generation to quickstart#25

Merged
imran-siddique merged 1 commit into
mainfrom
fix/quickstart-fixture
Jun 21, 2026
Merged

docs: add sample fixture generation to quickstart#25
imran-siddique merged 1 commit into
mainfrom
fix/quickstart-fixture

Conversation

@imran-siddique

Copy link
Copy Markdown
Contributor

Summary

  • Adds a generate_sample.py script and install step so users have a concrete way to produce a valid signed Level 0 trust record before running trace-tests for the first time
  • Fixes the usability blocker where the quickstart referenced path/to/trust-record.json but never showed how to get one
  • Updates "Run all levels" block to use the generated file and adds a note that Level 1/2 failures on the sample fixture are expected
  • Fixes two broken Next Steps links (../modules.mdmodules/index.md, ../error-codes.mderror-codes.md)

Test plan

  • MkDocs builds without warnings
  • All links in Next Steps table resolve
  • Script block is syntactically valid Python

Adds a generate_sample.py script and step-by-step instructions so
users can produce a valid signed Level 0 trust record before running
trace-tests for the first time. Fixes the usability gap where the
quickstart referenced a record file but gave no way to obtain one.

Also fixes broken Next Steps links (modules.md -> modules/index.md,
error-codes relative path).

Signed-off-by: Imran Siddique <imran.siddique@opaque.co>
@imran-siddique imran-siddique merged commit e34d5d2 into main Jun 21, 2026
5 checks passed
@imran-siddique imran-siddique deleted the fix/quickstart-fixture branch June 21, 2026 21:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant