Skip to content

docs: add Trust Levels, Glossary, Platforms index; fix quickstart - #56

Merged
imran-siddique merged 1 commit into
mainfrom
docs/trust-levels-and-glossary
Jun 21, 2026
Merged

imran-siddique merged 1 commit into
mainfrom
docs/trust-levels-and-glossary

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

Summary

  • Trust Levels page (docs/trust-levels.md): defines Level 0/1/2 in one place — what each level proves, what it does not prove, minimum required fields at each level, and a decision table for choosing a level. Closes the audit gap where these levels appeared throughout the docs but were never defined on a single page.
  • Glossary (docs/glossary.md): defines Trust Record, Trust Level, Appraisal, Conformance, EAT, RATS, SCITT, cnf/JWK, RIM, SPIFFE, Transparency, GatewayClaim, JCS.
  • Platforms index (docs/platforms/index.md): overview page for the Platforms nav section. Lists all four TEE platforms, their runtime.platform values, and explains how Level 1 verification works. Previously the Platforms nav had no overview entry.
  • Quickstart standalone path: adds a sign_record() example before the AGT govern() example so the quickstart is usable without installing AGT.
  • Remove supernav.js from mkdocs.yml (missed in the earlier theme-alignment PR).

Test plan

  • MkDocs builds without warnings (mkdocs build --strict)
  • All three new pages appear in the nav
  • Platforms nav has Overview entry above AMD SEV-SNP
  • Trust Levels page is under Getting Started
  • Glossary page is under Getting Started
  • Quickstart standalone section works before AGT section

- Add docs/trust-levels.md: Level 0/1/2 definitions, minimum required
  fields per level, decision table, and relationships to platforms and
  test suite
- Add docs/glossary.md: definitions for Trust Record, Trust Level,
  Appraisal, Conformance, EAT, RATS, SCITT, cnf/JWK, RIM, SPIFFE,
  Transparency, GatewayClaim, JCS
- Add docs/platforms/index.md: overview of supported TEE platforms,
  platform table, and how Level 1 verification works
- Update docs/quickstart.md: add standalone sign_record() example
  before the AGT section so users can produce a Level 0 record without
  any external framework dependency
- Update mkdocs.yml: add Trust Levels, Glossary, and Platforms overview
  to nav; remove supernav.js

Signed-off-by: Imran Siddique <imran.siddique@opaque.co>
@imran-siddique
imran-siddique merged commit 8a76c17 into main Jun 21, 2026
4 checks passed
@imran-siddique
imran-siddique deleted the docs/trust-levels-and-glossary branch June 21, 2026 21:35
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