Documentation edits made through Mintlify web editor

Author: ethanpalm

guides/assistant.mdx

@@ -5,8 +5,11 @@ icon: "bot"
 ---
 
 <Info>
-  The AI assistant is available on [Pro, Growth, and Enterprise plans](https://mintlify.com/pricing?ref=assistant). Please{" "}
-  <a href="mailto:[email protected]">contact sales</a> for more information.
+  The AI assistant is available on [Pro, Growth, and Enterprise plans](https://mintlify.com/pricing?ref=assistant). Please" "
+  <a href="mailto:[email protected]">
+  contact sales</a>
+
+   for more information.
 </Info>
 
 ## About the assistant
@@ -23,7 +26,15 @@ The assistant is automatically enabled for accounts on Pro, Growth, and Enterpri
 
 There are two ways to access the assistant in your documentation:
 
-- **Use the keyboard shortcut** <kbd>Command</kbd> + <kbd>I</kbd> (<kbd>Ctrl</kbd> + <kbd>I</kbd> on Windows).
+- **Use the keyboard shortcut** <kbd>Command</kbd>
+
+   \+ <kbd>I</kbd>
+
+   (<kbd>Ctrl</kbd>
+
+   \+ <kbd>I</kbd>
+
+   on Windows).
 - **Select the assistant button** next to the search bar.
 
   <Frame>
@@ -54,19 +65,16 @@ To help the assistant provide accurate answers, structure your documentation wit
 - Create a logical information hierarchy with proper nesting (H1 \> H2 \> H3).
 - Break up long blocks of text into shorter paragraphs.
 - Use consistent formatting across your docs.
+- Use semantic markup.
+- Include comprehensive metadata in page frontmatter.
 
 ### Context
 
 - Define specific terms and acronyms when first introduced.
 - Provide sufficient conceptual content about features and procedures.
 - Include examples and use cases.
 - Cross-reference related topics.
-
-### AI optimization
-
-- Add hidden pages with additional context that users don't need, but the assistant can reference. See [Hidden pages](/guides/hidden-pages#ai-context) for more information.
-- Use semantic markup.
-- Include comprehensive metadata in page frontmatter.
+- Add [hidden pages](/guides/hidden-pages) with additional context that users don't need, but the assistant can reference.
 
 ## Exporting queries
 
@@ -105,4 +113,4 @@ Available models:
 - o3-mini
 - Gemini 2.5 Pro (Preview)
 - Llama 4 Maverick
-- Grok 3
+- Grok 3

guides/hidden-pages.mdx

@@ -16,11 +16,13 @@ If you want to hide pages for specific groups of users, use personalization to c
 
 A page is hidden if it is not included in your `docs.json` navigation. To hide a page, remove it from your navigation structure.
 
+Hidden pages use the same URL structure as regular pages based on their file path.  For example,  `guides/hidden-page.mdx` would be accessible at `docs.yoursite.com/guides/hidden-page`.
+
 <Note>
-Some navigation elements like sidebars, dropdowns, and tabs may appear empty or shift layout on hidden pages.
+  Some navigation elements like sidebars, dropdowns, and tabs may appear empty or shift layout on hidden pages.
 </Note>
 
-## Search, SEO, and AI context
+## Search, SEO, and AI indexing
 
 By default, hidden pages are excluded from indexing for search engines, internal search within your docs, and as context for the AI assistant. To include hidden pages in search results and as context for the assistant, add the `seo` property to your `docs.json`:
 
@@ -30,4 +32,4 @@ By default, hidden pages are excluded from indexing for search engines, internal
 }
 ```
 
-To exclude a specific page, add `noindex: "true"` to its frontmatter.
+To exclude a specific page, add `noindex: "true"` to its frontmatter.