Task based IA (#1353)

* implement task-based IA

* rearrange pages

* tag examples

* add cookbook example

* add a components menu

* rename cookbook to guides

* fix docs.json after adding translations

* prettier docs.json

* move content to Guides

* move GEO page to guides

* draft of ai-native page

* update body with info on reading/distributing

* copy edits

* 💅

* move guides above API reference

* remove CLI sidebarTitle

* update organization

* remove tags

* remove guides icons

* Update ai-native.mdx

* Update ai-native.mdx

* copyedits

* 💅

* even number of cards

* update discovering section

* remove components tab

* remove icons

* remove icon

* add group level icons

* update Get started group

* Update organize group

* update customize group

* update create content group

* shorten URLs

* update API group

* update deploy group

* update optimize and guides groups

* set up redirects

* update links

* add pdf page

* add missing icons

* remove default expanded state

* update docs.json

Author: ethanpalm

ai-native.mdx

@@ -0,0 +1,47 @@
+---
+title: "AI-native"
+description: "Learn how AI enhances reading, writing, and discovering your documentation"
+---
+
+When you host your documentation on Mintlify, built-in AI features help your users find answers and your team maintain content more efficiently. Your content provides the context for these AI-native features to improve the experiences of reading, writing, and discovering your documentation.
+
+## What makes your documentation AI-native
+
+### Reading
+
+In addition to reading individual pages, users can chat with the [assistant](/ai/assistant) in your documentation for immediate answers to their questions and links to relevant content. The assistant helps guide users through your product with accurate information from your documentation. Embed the assistant into custom apps with the [API](api-reference/assistant/create-assistant-message) to extend where users can access your documentation.
+
+### Writing
+
+The [agent](/ai/agent) helps you write and maintain documentation. It creates pull requests with proposed changes based on your prompts, pull requests, and Slack threads. Add the agent to your Slack workspace so that anyone on your team can help maintain your documentation by chatting with the agent. Or embed the agent into custom apps via the [API](/api-reference/agent/create-agent-job).
+
+Configure popular tools like [Cursor](/guides/cursor), [Claude Code](/guides/claude-code), and [Windsurf](/guides/windsurf) to reference the Mintlify schema, your style guide, and best practices.
+
+### Discovering
+
+Your site is automatically optimized for AI tools and search engines to help users discover your documentation. All pages are sent as Markdown to AI agents instead of HTML, which helps these tools process your content faster and use fewer tokens. Every page is also available to view as Markdown by appending `.md` to the URL.
+
+Mintlify hosts `llms.txt` and `llms-full.txt` files for your documentation. These industry-standard files help LLMs index your documentation and respond efficiently with relevant information to user queries.
+
+Your documentation site also hosts an MCP server that lets users connect your documentation directly to their AI tools for up to date information about your product directly where they want it.
+
+Full-text search and semantic understanding help users and AI tools find relevant information quickly. Search understands user intent rather than just matching keywords. And if a user encounters a 404 error, your site suggests related pages to help them find what they're looking for. No configuration required.
+
+## 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>

ai/agent.mdx

@@ -1,7 +1,6 @@
 ---
 title: "Agent"
 description: "The agent helps you write and maintain documentation"
-icon: "pen-line"
 ---
 
 <Info>

guides/assistant.mdx renamed to ai/assistant.mdx

@@ -1,7 +1,6 @@
 ---
 title: "Assistant"
 description: "Help users succeed with your product and find answers faster"
-icon: "bot"
 ---
 
 <Info>
@@ -114,7 +113,7 @@ Structure your documentation to help the assistant provide accurate, relevant an
   - Provide sufficient conceptual content about features and procedures.
   - Include examples and use cases.
   - Cross-reference related topics.
-  - Add [hidden pages](/guides/hidden-pages) with additional context that users don't need, but the assistant can reference.
+  - Add [hidden pages](/organize/hidden-pages) with additional context that users don't need, but the assistant can reference.
 </Card>
 
 ## Exporting and analyzing queries

ai/contextual-menu.mdx

@@ -1,7 +1,6 @@
 ---
 title: "Contextual menu"
 description: "Add one-click AI integrations to your docs"
-icon: "square-menu"
 ---
 
 import { PreviewButton } from "/snippets/previewbutton.jsx"

ai/llmstxt.mdx

@@ -1,7 +1,6 @@
 ---
 title: "llms.txt"
 description: "Make your content easier for LLMs to read and index"
-icon: "file-code"
 ---
 
 import { PreviewButton } from "/snippets/previewbutton.jsx"

ai/markdown-export.mdx

@@ -1,7 +1,6 @@
 ---
 title: "Markdown export"
 description: "Quickly get Markdown versions of pages"
-icon: "file-text"
 ---
 
 import { PreviewButton } from "/snippets/previewbutton.jsx"

ai/model-context-protocol.mdx

@@ -1,7 +1,6 @@
 ---
 title: "Model Context Protocol"
 description: "Let users access your docs and APIs through their favorite AI tools"
-icon: "audio-waveform"
 keywords: ["mcp"]
 ---
 

ai/slack-app.mdx

@@ -1,7 +1,6 @@
 ---
 title: "Slack app"
 description: "Add a bot that searches your docs to answer questions in your Slack workspace"
-icon: "slack"
 ---
 
 <Info>