Skip to content

feat: introduce kosli next product for forward-looking docs#237

Draft
dangrondahl wants to merge 2 commits into
mainfrom
kosli_next
Draft

feat: introduce kosli next product for forward-looking docs#237
dangrondahl wants to merge 2 commits into
mainfrom
kosli_next

Conversation

@dangrondahl
Copy link
Copy Markdown
Contributor

Summary

Introduce a second Mintlify Product, Kosli Next, alongside the existing Product surface. Kosli Next is the home for forward-looking content we want customer feedback on, kept clearly separate from what Kosli does today.

  • Restructured config/navigation.json to use a top-level products array. Existing tabs sit under "Product"; "Kosli Next" has direct groups for Concepts and Preview.
  • New content: a Controls concept page and an MCP Server preview page, plus a landing page with light/dark hero images.
  • Shared Callout-based banner snippet (snippets/kosli-next-banner.mdx) carrying the disclaimer and feedback channel for every Kosli Next page. Single source of truth so the feedback channel can be swapped later.
  • Sidebar tag pills (Concept, Preview) recoloured via style.css to match their on-page callouts.
  • .mintlify/AGENTS.md defines retrieval rules, the required disclaimer when citing Kosli Next, and writing rules - applies to the dashboard agent, the @mintlify Slack bot, and the docs site assistant.
  • Repo-local Claude skill at .claude/skills/kosli-next-writer/ plus a pointer from CLAUDE.md, so colleagues writing Kosli Next pages get consistent guidance.
  • No-em-dash rule added to CLAUDE.md and applied across files.
  • Kosli Next link added to the footer.

Test plan

  • mint dev locally - Product switcher shows "Product" and "Kosli Next"; default landing is "Product".
  • Kosli Next sidebar shows Concepts and Preview groups; pages render with their callout and tag pill.
  • Tag pill colours match callout colours (peach for Concept, blue for Preview) in light and dark mode.
  • mint broken-links passes.
  • Ask the dashboard agent a current-product question - answer cites Product only, no disclaimer.
  • Ask a future/preview question - answer cites the Kosli Next page WITH the disclaimer.

Add a second Mintlify Product, "Kosli Next", alongside the existing
"Product" surface, for content that is not yet available in Kosli.
Kosli Next has two tabs:

- Concepts - ideas we want feedback on; nothing built.
- Preview - opt-in pre-GA features.

Includes:

- Restructured config/navigation.json under a top-level products array.
- New kosli_next/ landing, concepts, and preview seed pages.
- Shared banner snippet (snippets/kosli-next-banner.mdx) carrying the
  disclaimer and feedback channel, so it can be swapped centrally.
- .mintlify/AGENTS.md with retrieval rules, the required disclaimer
  when citing Kosli Next, and writing rules for the @mintlify Slack
  bot and dashboard agent.
- .claude/skills/kosli-next-writer/ for repo-local Claude sessions,
  plus a pointer from CLAUDE.md.
- No-em-dash rule added to CLAUDE.md and applied across the file.
- Kosli Next link added to the footer.
- Collapse Kosli Next from two tabs to direct groups (Concepts, Preview)
  under the product.
- Add the Controls concept page and the MCP Server preview page with
  matching images.
- Switch banners to a Callout component, with peach (Concepts) and blue
  (Preview) colours, and recolour the sidebar tag pills to match via
  data-nav-tag selectors in style.css.
- Add light/dark hero images to the Kosli Next landing page.
- Ignore .DS_Store globally.
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 22, 2026

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

Project Status Preview Updated (UTC)
kosli 🟢 Ready View Preview May 22, 2026, 12:34 PM

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