Skip to content

feat: add flow template reference page and JSON schema - #71

Merged
dangrondahl merged 2 commits into
mainfrom
add_template_ref
Mar 16, 2026
Merged

dangrondahl merged 2 commits into
mainfrom
add_template_ref

Conversation

@dangrondahl

@dangrondahl dangrondahl commented Mar 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Adds a Templates item to the Reference tab in navigation with a "Flow Templates" group
  • Rewrites template-reference/flow_template.md using <ParamField> + <Expandable> components for the spec, links to relevant CLI commands, and includes a YAML example with the schema comment
  • Adds schemas/flow-template.json — a JSON Schema (draft-07) for flow template YAML files, served at https://kosli.mintlify.app/schemas/flow-template.json
  • Users can enable editor validation and autocomplete by adding # yaml-language-server: $schema=https://kosli.mintlify.app/schemas/flow-template.json to their template files

@dangrondahl
dangrondahl merged commit b325766 into main Mar 16, 2026
4 checks passed
@dangrondahl
dangrondahl deleted the add_template_ref branch March 16, 2026 14:18
dangrondahl added a commit that referenced this pull request Mar 16, 2026
…ns example (#73)

## Summary

- Adds `# yaml-language-server: $schema=...` comment to the flow
template example in the attestations getting started page
- Adds a `<Tip>` callout linking to the [Flow Template
reference](/template-reference/flow_template) for the full spec and
editor validation details

Depends on #71 (which adds the schema file and template reference page).

This branch was successfully deployed

1 active deployment
staging — 089b1d7f Deployed Mar 16, 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.

1 participant