Skip to content

docs: add OPA tutorial and Rego policy reference#82

Merged
dangrondahl merged 2 commits intomainfrom
add_opa_tutorial
Mar 18, 2026
Merged

docs: add OPA tutorial and Rego policy reference#82
dangrondahl merged 2 commits intomainfrom
add_opa_tutorial

Conversation

@dangrondahl
Copy link
Contributor

@dangrondahl dangrondahl commented Mar 18, 2026

Summary

  • Adds a tutorial for evaluating Kosli trails with OPA/Rego policies, covering writing policies, evaluating single and multiple trails, exploring input data with --show-input, CI/CD gating, and recording evaluation results as attestations
  • Adds a Rego Policy reference page (alongside the existing Template Reference) covering the policy contract, input data shapes, exit codes, and annotated examples
  • Adds Rego syntax highlighting support via a custom TextMate grammar (languages/rego.json)

Adds a dedicated Policy Reference page covering the policy contract,
input data shape, exit codes, and annotated examples. Refactors the
OPA tutorial to link out to the reference rather than embedding
reference content mid-step, and removes em dashes from prose.
@dangrondahl dangrondahl merged commit 9e59584 into main Mar 18, 2026
5 checks passed
@dangrondahl dangrondahl deleted the add_opa_tutorial branch March 18, 2026 15:14
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.

2 participants