add latest specs, add documents page.

Author: eyw520

fern/apis/fai/definition/document.yml

@@ -40,7 +40,59 @@ service:
             authed:
               type: optional<boolean>
               docs: Whether the document is authed
-      response: CreateDocumentResponse
+      response: DocumentIdResponse
+      errors:
+        - commons.BadRequestError
+        - commons.InternalError
+    
+    updateDocument:
+      docs: Update a document for a given domain
+      path: /{domain}/{document_id}
+      method: PATCH
+      audiences:
+        - customers
+      path-parameters:
+        domain: string
+        document_id: string
+      request:
+        name: UpdateDocumentRequest
+        body:
+          properties:
+            document:
+              type: optional<string>
+              docs: The content of the document that will be returned in the tool response.
+            chunk:
+              type: optional<string>
+              docs: The chunk of the document that will be indexed as a vector.
+            title:
+              type: optional<string>
+              docs: The title of the document
+            url:
+              type: optional<string>
+              docs: The url of the document
+            version:
+              type: optional<string>
+              docs: The version of the document
+            keywords:
+              type: optional<list<string>>
+              docs: The keywords of the document
+            authed:
+              type: optional<boolean>
+              docs: Whether the document is authed
+      response: Document
+      errors:
+        - commons.BadRequestError
+        - commons.InternalError
+
+    deleteDocumentById:
+      docs: Delete a document for a given domain
+      path: /{domain}/{document_id}
+      method: DELETE
+      audiences:
+        - customers
+      path-parameters:
+        domain: string
+        document_id: string
       errors:
         - commons.BadRequestError
         - commons.InternalError
@@ -60,7 +112,7 @@ service:
         - commons.InternalError
 
 types:
-  CreateDocumentResponse:
+  DocumentIdResponse:
     properties:
       document_id: string
 

fern/apis/fai/definition/guidance.yml

@@ -25,6 +25,7 @@ service:
             document:
               type: string
               docs: The content of the guidance document that will be returned in the tool response
+      response: GuidanceIdResponse
       errors:
         - commons.BadRequestError
         - commons.InternalError
@@ -101,6 +102,10 @@ service:
         - commons.InternalError
 
 types:
+  GuidanceIdResponse:
+    properties:
+      guidance_id: string
+
   Guidance:
     properties:
       guidance_id: string
@@ -113,10 +118,4 @@ types:
   GuidanceList:
     properties:
       guidances: list<Guidance>
-      pagination: Pagination
-
-  Pagination:
-    properties:
-      total: integer
-      page: integer
-      limit: integer
+      pagination: commons.Pagination

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

@@ -13,11 +13,13 @@ navigation:
     contents:
       - page: Citations
         path: ./pages/features/citations.mdx
-      - page: Custom FAQs
-        path: ./pages/features/custom-faqs.mdx
+      - page: Custom Guidance
+        path: ./pages/features/guidance.mdx
+      - page: Custom Documents
+        path: ./pages/features/documents.mdx
       - page: Insights
         path: ./pages/features/insights.mdx
-      - page: Evals
+      - page: Evaluation
         path: ./pages/features/evals.mdx
   - api: API reference
     api-name: fai

fern/products/ask-fern/pages/features/custom-faqs.mdx

@@ -0,0 +1,10 @@
+---
+title: Documents
+subtitle: Add arbitrary documents to Ask Fern. 
+---
+
+You can add arbitrary documents to Ask Fern. This is useful for adding additional content that may improve Ask Fern's accuracy 
+(such as help desk tickets, internal company FAQs, etc.). 
+
+Fern offers an internal CMS (content management system) via the `documents` API that allows you to add, update,
+and delete documents as needed. 

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

@@ -1,11 +1,14 @@
 ---
 title: Evals
-description: Benchmark Ask Fern's performance against competitors and track improvements.
+description: Benchmark Ask Fern's accuracy against your documentation.
 ---
 
+<Markdown src="/snippets/wip-callout.mdx" />
+
 Fern evaluates how accurately Ask Fern answers questions on your documentation site compared to competitor AI search solutions. 
 
-Fern first generates evaluation questions from your documentation files, then runs those questions through both Ask Fern and competitor systems. Finally, Fern evaluates each answer against the original documentation for accuracy. You receive detailed performance metrics and comparative analysis.
+Fern first generates evaluation questions from your documentation files, then runs those questions through both Ask Fern and competitor systems. 
+Finally, Fern evaluates each answer against the original documentation for accuracy. You receive detailed performance metrics and comparative analysis.
 
 ## Availability
 

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

@@ -0,0 +1,11 @@
+---
+title: Custom Guidance
+subtitle: Fine-tune your AI search responses. 
+---
+
+You can add custom guidance (FAQs) to "override" Ask Fern's responses to specific user queries. 
+This is useful for content that you may not wish to display publically, such as billing information, 
+legal terms, and other sensitive content.
+
+Fern offers an internal CMS (content management system) via the `guidance` API that allows you to add,
+update, and delete FAQs as needed. 

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

@@ -3,6 +3,8 @@ title: Insights
 description: Fern identifies documentation gaps and improvement opportunities from your user queries.
 ---
 
+<Markdown src="/snippets/wip-callout.mdx" />
+
 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 that analyze query-response pairs to identify documentation gaps, extract common themes, and generate specific suggestions for enhancing your docs.
 
 ## Availability