Skip to content

docs: add environment policy reference page - #127

Merged
dangrondahl merged 8 commits into
mainfrom
add_policy_reference
Apr 7, 2026
Merged

dangrondahl merged 8 commits into
mainfrom
add_policy_reference

Conversation

@dangrondahl

@dangrondahl dangrondahl commented Apr 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Add policy-reference/environment_policy.mdx — austere reference page for the YAML policy format, including field specification, attestation types, policy expression language, and editor validation
  • Restructure schema from schemas/policy.json to schemas/policy/v1.json so the _schema URL (https://kosli.mintlify.app/schemas/policy/v1) serves as both a version identifier and a fetchable JSON Schema
  • Add redirect from /schemas/policy/v1 → /schemas/policy/v1.json

- Add policy-reference/environment_policy.mdx with full YAML specification,
  expression language reference, and editor validation instructions
- Move schema from schemas/policy.json to schemas/policy/v1.json so the
  _schema URL can serve as both version identifier and fetchable resource
- Add redirect from /schemas/policy/v1 to /schemas/policy/v1.json
- Register new page in navigation under Policy Reference
@mintlify

mintlify Bot commented Apr 7, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
kosli 🟢 Ready View Preview Apr 7, 2026, 11:04 AM

Restore provenance, trail-compliance, attestations, and exceptions
sections to the policies guide so users don't need to leave the
getting-started flow. Update all _schema references from
kosli.com/schemas/policy/environment/v1 to
kosli.mintlify.app/schemas/policy/v1.
@dangrondahl
dangrondahl marked this pull request as ready for review April 7, 2026 12:33
@dangrondahl
dangrondahl requested a review from a team as a code owner April 7, 2026 12:33
@dangrondahl

Copy link
Copy Markdown
Contributor Author

Note: the server only checks for the v1 version segment of the _schema URL and skips the parts of the URL before that. So both kosli.com/schemas/policy/environment/v1 and kosli.mintlify.app/schemas/policy/v1 are accepted.

@dangrondahl
dangrondahl enabled auto-merge (squash) April 7, 2026 12:34
@dangrondahl
dangrondahl merged commit 91a95d8 into main Apr 7, 2026
5 checks passed
@dangrondahl
dangrondahl deleted the add_policy_reference branch April 7, 2026 14:19

This branch was successfully deployed

1 active deployment
staging — d005bc98 Deployed Apr 7, 2026 by mintlify[bot]
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