diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index 885e0b0f24..9651ce57d2 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -1,5 +1,5 @@ --- -title: "Contextual menu" +title: "Context" description: "Add a contextual menu to your docs with one-click AI integrations for ChatGPT, Claude, Perplexity, Google AI Studio, Devin, Devin Desktop, and MCP tools." keywords: ["AI tools", "ChatGPT", "Claude", "Perplexity", "MCP", "Grok", "cursor", "vscode", "vs code", "Google AI Studio", "aistudio", "Devin", "Windsurf", "Devin Desktop", "pdf", "copy page", "copy button", "copy markdown", "copy as markdown", "view as markdown", "context menu", "page menu", "AI menu", "AI actions", "open in", "download pdf", "export pdf", "ask ai", "openapi", "download spec"] --- @@ -18,7 +18,7 @@ The contextual menu provides quick access to AI-optimized content and direct int The contextual menu includes several pre-built options that you can enable by adding their identifier to your configuration. | Option | Identifier | Description | -|:--------|:------------|:-------------| +| :-- | :-- | :-- | | **Copy page** | `copy` | Copies the current page as Markdown for pasting as context into AI tools | | **View as Markdown** | `view` | Opens the current page as Markdown | | **Ask assistant** | `assistant` | Opens the [assistant](/assistant/index) with the current page as context | @@ -39,10 +39,7 @@ The contextual menu includes several pre-built options that you can enable by ad | **Custom options** | Object | Add custom options to the contextual menu | - The expanded contextual menu showing the Copy page, View as Markdown, Open in ChatGPT, and Open in Claude menu items. + ![The expanded contextual menu showing the Copy page, View as Markdown, Open in ChatGPT, and Open in Claude menu items.](/images/contextual-menu/contextual-menu.png) ## Enable the contextual menu @@ -88,7 +85,7 @@ By default, the contextual menu appears in the page header. You can configure it ``` | Value | Description | -|:------|:------------| +| :-- | :-- | | `header` | Displays options in the top-of-page context menu (default) | | `toc` | Displays options in the table of contents sidebar | @@ -108,7 +105,7 @@ Create custom options in the contextual menu by adding an object to the `options The href of the option. Use a string for simple links or an object for dynamic links with query parameters. - + The base URL for the option. @@ -124,6 +121,7 @@ Create custom options in the contextual menu by adding an object to the `options The query parameter value. Mintlify replaces the following placeholders with the corresponding values: + - Use `$page` to insert the current page content in Markdown. - Use `$path` to insert the current page path. - Use `$mcp` to insert the hosted MCP server URL. @@ -135,7 +133,7 @@ Create custom options in the contextual menu by adding an object to the `options Example custom option: -```json {9-14} wrap +```json highlight={9-14} wrap { "contextual": { "options": [ @@ -158,33 +156,33 @@ Example custom option: ### Custom option examples - -```json -{ - "title": "Request a feature", - "description": "Join the discussion on GitHub", - "icon": "plus", - "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests" -} -``` - - - -```json -{ - "title": "Share on X", - "description": "Share this page on X", - "icon": "x", - "href": { - "base": "https://x.com/intent/tweet", - "query": [ - { - "key": "text", - "value": "Check out this documentation: $page" + + ```json + { + "title": "Request a feature", + "description": "Join the discussion on GitHub", + "icon": "plus", + "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests" + } + ``` + + + + ```json + { + "title": "Share on X", + "description": "Share this page on X", + "icon": "x", + "href": { + "base": "https://x.com/intent/tweet", + "query": [ + { + "key": "text", + "value": "Check out this documentation: $page" + } + ] } - ] - } -} -``` - + } + ``` + \ No newline at end of file diff --git a/docs.json b/docs.json index b624806509..27e17a6ad8 100644 --- a/docs.json +++ b/docs.json @@ -224,20 +224,71 @@ "root": "assistant/index", "pages": [ "assistant/configure", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", + "optimize/seo", "assistant/customize", "assistant/skills", "assistant/use" ] }, "credits", - "ai/contextual-menu", "optimize/analytics", "optimize/feedback", "ai/llmstxt", "ai/skillmd", "ai/model-context-protocol", "optimize/search", - "optimize/seo", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", + "ai/contextual-menu", "ai/markdown-export", "optimize/pdf-exports", { diff --git a/optimize/analytics.mdx b/optimize/analytics.mdx index 3a224d86a8..72426ed642 100644 --- a/optimize/analytics.mdx +++ b/optimize/analytics.mdx @@ -1,7 +1,7 @@ --- title: "Analytics" description: "Track documentation analytics in the Mintlify dashboard to understand page views, visitor trends, search queries, and content effectiveness." -keywords: ["analytics","metrics","page views","traffic","trends","insights"] +keywords: ["analytics", "metrics", "page views", "traffic", "trends", "insights"] boost: 3 --- @@ -9,7 +9,7 @@ boost: 3 Analytics require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics). -The [analytics](https://app.mintlify.com/products/analytics/v2/) page in your dashboard shows data about visitors to your docs, how they interact with the assistant, what they search for, and their feedback. Use this information to identify which pages are most valuable to your users and track trends over time. +The [analytics](https://app.mintlify.com/products/analytics/v2/) page in your dashboard shows data about visitors to your docs, how they interact with the assistan awef awef awef awef awt, what they search for, and their feedback. Use this information to identify which pages are most valuable to your users and track trends over awef awef awef aweftime. awef ## Filter by AI or human visitors @@ -17,15 +17,14 @@ Filter your analytics data by traffic source to analyze AI agent traffic separat The traffic source filter on the analytics page. - The traffic source filter on the analytics page. @@ -37,15 +36,14 @@ Use the range selector to adjust the time period for displayed data. The range selector expanded to show options for viewing different time periods of data. - The range selector expanded to show options for viewing different time periods of data. @@ -94,15 +92,14 @@ The categories tab uses LLMs to automatically group conversations by topic or th The categories tab in the assistant analytics page. - The categories tab in the assistant analytics page. @@ -121,7 +118,7 @@ Click any message to view the complete chat thread, including the user's questio ## Searches -The Searches metric is only available when viewing human traffic. + The Searches metric is only available when viewing human traffic. The searches tab displays a bar chart of searches over time and specific queries. @@ -135,7 +132,7 @@ Review your searches analytics to: ## MCP searches -The MCP Searches metric is only available when viewing AI traffic. + The MCP Searches metric is only available when viewing AI traffic. The MCP searches tab displays AI agent search interactions through the Model Context Protocol (MCP). This metric counts calls to your MCP server's search tool. It reflects agents that users connected to your MCP server and then issued a search, not general AI crawler traffic to your docs pages. @@ -157,10 +154,10 @@ See [Feedback](/optimize/feedback) for more information on using feedback data t Export any analytics tab to CSV for deeper analysis, reporting, or archival. Exports respect the current traffic source and time range filters. 1. Navigate to the [analytics](https://app.mintlify.com/products/analytics/) page of your dashboard. -1. Click the tab you want to export. -1. Optionally, adjust the traffic source and time range to narrow down the data you want to export. -1. Click **Export to CSV**. -1. Mintlify sends you an email with a download link when the export is ready. +2. Click the tab you want to export. +3. Optionally, adjust the traffic source and time range to narrow down the data you want to export. +4. Click **Export to CSV**. +5. Mintlify sends you an email with a download link when the export is ready. ### Assistant exports @@ -172,4 +169,4 @@ Assistant exports include the queries, responses, sources, and a `resolutionStat - List any queries that had no sources cited. - Find patterns in unsuccessful interactions. - Group unanswered queries by topic to prioritize content updates. - + \ No newline at end of file