Skip to content

Add poetic version of AI-native documentation #1820

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

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Add poetic version of AI-native documentation #1820

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
71 changes: 71 additions & 0 deletions ai-native-poem.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
---
title: "AI-native"
description: "Learn how AI enhances reading, writing, and discovering your documentation"
keywords: ["AI", "assistant", "agent", "llms.txt", "MCP"]
---

When documentation lives on Mintlify's shore,
AI features help you find so much more.
Your content provides the context and light,
For AI-native features to work just right.

## What makes your documentation AI-native

### Reading

Beyond pages read one by one,
Chat with the [assistant](/ai/assistant) till answers come.
It guides through your product with knowledge so true,
From documentation that's written by you.
Embed it in apps with the [API](api-reference/assistant/create-assistant-message) so grand,
To extend where your docs can lend a hand.

### Writing

The [agent](/ai/agent) helps maintain and create,
Pull requests it makes, no need to wait.
From prompts and threads in Slack's domain,
Anyone on your team can help maintain.
Add it to Slack or embed with care,
Via [API](/api-reference/agent/create-agent-job) it's everywhere.

Configure [Cursor](/guides/cursor), [Claude Code](/guides/claude-code), [Windsurf](/guides/windsurf) with ease,
Reference your schema and style guides, if you please.

### Discovering

Your site's optimized for AI to find,
Markdown not HTML, efficient and kind.
Every page can be viewed with `.md` at the end,

Check warning on line 39 in ai-native-poem.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai-native-poem.mdx#L39 

In general, use active voice instead of passive voice ('be viewed').
Faster processing, fewer tokens to spend.

`llms.txt` and `llms-full.txt` reside,
Industry standards to help LLMs guide.
Index your docs and respond with speed,
Relevant information for every need.

An MCP server your site does host,
Connect your docs where users need them most.
Full-text search with semantic grace,
Understands intent, not just words in place.
And when 404 errors appear in sight,
Related pages suggested make things right.

## Enable AI features

Select any of the following cards for more information.

<CardGroup cols={2}>
<Card title="Assistant" icon="bot-message-square" href="/ai/assistant">
Configure the assistant to search external sites or direct people to your support team if it can't answer their questions.
</Card>
<Card title="Agent" icon="pen-line" href="/ai/agent">
Add the agent to your Slack workspace or embed it into custom apps to have it help write and update your documentation.
</Card>
<Card title="Contextual menu" icon="sparkles" href="/ai/contextual-menu">
Add a menu to pages that lets users query AI tools, connect to your MCP server, and copy pages as context with one click.
</Card>
<Card title="MCP integration" icon="plug" href="/ai/model-context-protocol">
Your site has a hosted MCP server that lets users connect your documentation directly to their AI tools. Make your users aware of your MCP server and how to connect to it.
</Card>
</CardGroup>