Documentation edits made through Mintlify web editor

Author: ethanpalm

guides/assistant.mdx

@@ -24,7 +24,27 @@ The assistant is automatically enabled for accounts on Pro, Growth, and Enterpri
 
 ## Making content AI ingestible
 
-Best practices
+To help the assistant provide accurate answers, structure your documentation with both human readers and AI tools in mind. Well-organized, thorough content makes it easier for the assistant to understand your documentation and deliver relevant responses to users.
+
+### Structure and organization
+
+- Write descriptive headings that indicate what setions are about.
+- 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.
+
+### 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.
+- Use semantic markup.
+- Include comprehensive metadata in pages' frontmatter.
 
 ## Exporting queries