Kosli Documentation

Source for docs.kosli.com, built with Mintlify.

Development

Install the Mintlify CLI (requires Node.js v19+):

npm i -g mint

Start a local preview at http://localhost:3000:

mint dev

Other useful commands:

mint broken-links   # Validate all internal links
mint a11y           # Check colour contrast and accessibility
mint update         # Update the CLI

Content

• docs.json — Theme and site configuration. Uses $ref to compose from files in config/.
• config/ — Split config: navigation.json (page routing — every new page must be added here), redirects.json, footer.json.
• Content directories — understand_kosli/, getting_started/, administration/, integrations/, implementation_guide/, client_reference/, terraform-reference/, api-reference/
• snippets/ — Reusable MDX fragments (only for content used in 2+ pages)
• changelog/ — Product changelog

See CLAUDE.md for full authoring conventions.

Deployment

Opening a PR automatically creates a Mintlify preview environment. Merging to main deploys to production automatically via the Mintlify GitHub app.

Automation

.mintlify/workflows/update-changelog.md — A Mintlify agent workflow that runs every Monday at 09:00 UTC. It reviews all PRs merged to kosli-dev/cli and kosli-dev/terraform-provider-kosli since the last changelog entry and writes a new <Update> block to changelog/index.mdx. Notifications are posted to the #docs Slack channel.