Skip to content

Update What is Mintlify page with AI era positioning #5125

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mintlify wants to merge 2 commits into from
Closed

Update What is Mintlify page with AI era positioning #5125

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a56764c
Update what-is-mintlify.mdx
mintlify[bot] Apr 3, 2026
c19aa28
Update what-is-mintlify.mdx
mintlify[bot] Apr 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions what-is-mintlify.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,15 @@
keywords: ["overview", "how it works", "architecture"]
---

Mintlify hosts your content as a website. Your content lives in a Git repository as MDX files, and Mintlify builds and deploys your site automatically when you push a change.
Mintlify is a documentation platform built for the AI era. Your content lives in a Git repository as MDX files, and Mintlify builds and deploys your site automatically when you push a change. But unlike traditional documentation platforms, Mintlify treats your documentation as critical infrastructure—the knowledge layer that powers both human developers and AI agents.

## Why documentation matters more than ever

As AI models get better, the bottleneck shifts from the model to the context you give it. A smarter model reading stale documentation just produces more confident wrong answers. The teams getting the best results from AI aren't chasing the latest model release—they're engineering what goes into the context window for each request.

Your documentation is now the primary interface through which AI understands your product. When a developer asks their coding assistant how to authenticate with your API, the assistant queries your documentation. When an AI agent evaluates whether to recommend your product, it's reading your docs. If your documentation is incomplete, poorly structured, or invisible to AI systems, you lose that evaluation without ever knowing it happened.

Mintlify was built to solve this problem. Your documentation becomes AI-native infrastructure that serves both humans browsing your site and AI systems consuming it programmatically.

Check warning on line 15 in what-is-mintlify.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

what-is-mintlify.mdx#L15 

In general, use active voice instead of passive voice ('was built').

## The three parts of a Mintlify project

Expand Down Expand Up @@ -37,7 +45,9 @@

The **assistant** lets your users ask questions and get cited answers from your content.

The **agent** helps your team create and maintain content by generating updates from scheduled workflows, pull requests merging in your feature repository, or Slack threads.
The **agent** helps your team create and maintain content by generating updates from scheduled workflows, pull requests merging in your feature repository, or Slack threads. As AI agents ship code faster than teams can document it, automated workflows keep your documentation current without manual intervention.

Your documentation is automatically optimized for AI consumption with machine-readable formats (Markdown export, `llms.txt`, `skill.md`), an MCP server for real-time queries, and semantic search that understands intent rather than just matching keywords.

See [AI-native documentation](/ai-native) for an overview of all AI features.

Expand Down
Loading