add new insights page

Author: devalog

fern/products/ask-fern/ask-fern.yml

@@ -15,6 +15,10 @@ navigation:
         path: ./pages/features/citations.mdx
       - page: Custom FAQs
         path: ./pages/features/custom-faqs.mdx
+      - page: Insights
+        path: ./pages/features/insights.mdx
+      - page: Evals
+        path: ./pages/features/evals.mdx
   - api: API Reference
     api-name: fai
     icon: fa-regular fa-pro

fern/products/ask-fern/pages/features/evals.mdx

@@ -0,0 +1,4 @@
+---
+title: Evals
+subtitle: Point users to the exact source of the answer. 
+---

fern/products/ask-fern/pages/features/insights.mdx

@@ -0,0 +1,16 @@
+---
+title: Insights
+description: Fern identifies documentation gaps and improvement opportunities from your user queries.
+---
+
+Fern analyzes Ask Fern query patterns to surface actionable recommendations for improving your documentation. After collecting sufficient query data over a month, Fern processes this through specialized models to identify documentation gaps, common themes, and areas where your docs could be enhanced.
+
+The Fern processes your Ask Fern usage data in three steps:
+
+1. Data Collection: All user queries and responses are logged as they occur
+1. Analysis: Fern's insights model analyzes query-response pairs to identify patterns and themes
+1. Recommendations: The system generates specific, actionable suggestions for documentation improvements
+
+## Availability
+
+Insights are currently provided as a monthly report delivered directly by the Fern team.