docs: add documentation for ai-search locations and datasources configuration

Co-Authored-By: [email protected] <[email protected]>

Author: devin-ai-integration[bot]

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

@@ -11,6 +11,8 @@ navigation:
     contents:
       - page: Custom prompts
         path: ./pages/configuration/custom-prompting.mdx
+      - page: Locations and datasources
+        path: ./pages/configuration/locations-and-datasources.mdx
       - page: Guidance
         path: ./pages/features/guidance.mdx
       - page: Documents
@@ -36,4 +38,4 @@ navigation:
       - customers
     layout:
       - page: Overview
-        path: ./pages/getting-started/api-get-started.mdx
+        path: ./pages/getting-started/api-get-started.mdx

fern/products/ask-fern/pages/configuration/locations-and-datasources.mdx

@@ -0,0 +1,105 @@
+---
+title: Locations and Datasources
+subtitle: Configure where Ask Fern is available and what content it can access.
+---
+
+<Markdown src="/snippets/pro-plan.mdx" />
+
+Ask Fern can be configured to appear in multiple locations and pull content from various datasources. This allows you to provide AI-powered assistance wherever your users need it and ensure the AI has access to all relevant information.
+
+## Locations
+
+The `location` field in your `ai-search` configuration determines where Ask Fern will be available to your users. You can specify one or more locations:
+
+```yaml docs.yml
+ai-search:
+  location:
+    - docs
+    - slack
+    - discord
+```
+
+### Available Locations
+
+<ParamField path="docs" type="string">
+  Enables Ask Fern on your documentation site. Users will see the AI search interface directly in your docs.
+</ParamField>
+
+<ParamField path="slack" type="string">
+  Enables Ask Fern in Slack. Learn more about the [Slack app integration](/ask-fern/features/slack-app).
+</ParamField>
+
+<ParamField path="discord" type="string">
+  Enables Ask Fern in Discord. This allows your community to get AI-powered answers in your Discord server.
+</ParamField>
+
+## Datasources
+
+The `datasources` field allows you to specify additional content sources that Ask Fern should index and search. This is useful when you want to include content from external websites or documentation that isn't part of your main docs.
+
+```yaml docs.yml
+ai-search:
+  datasources:
+    - url: https://example.com/additional-docs
+      title: Additional Documentation
+    - url: https://blog.example.com
+      title: Company Blog
+```
+
+### Website Datasources
+
+<ParamField path="url" type="string" required>
+  The URL of the website to index. Ask Fern will crawl and index the content from this URL.
+</ParamField>
+
+<ParamField path="title" type="string">
+  An optional display name for this datasource. This helps users understand where the information is coming from when Ask Fern cites content from this source.
+</ParamField>
+
+## Complete Example
+
+Here's a complete example showing how to configure both locations and datasources:
+
+```yaml docs.yml
+ai-search:
+  system-prompt: |
+    You are a helpful AI assistant for our documentation.
+    Provide clear, accurate answers based on the available documentation.
+  model: claude-3.7
+  location:
+    - docs
+    - slack
+  datasources:
+    - url: https://help.example.com
+      title: Help Center
+    - url: https://blog.example.com
+      title: Engineering Blog
+```
+
+## Preview Environments
+
+When using `fern generate --preview`, the `location` configuration determines whether Ask Fern will be enabled in your preview environment. If you specify `location: [docs]`, Ask Fern will be available in your preview deployments, allowing you to test the AI search functionality before publishing to production.
+
+<Note>
+  Preview environments use separate namespaces to ensure that test data doesn't interfere with your production Ask Fern instance.
+</Note>
+
+## Best Practices
+
+<AccordionGroup>
+  <Accordion title="Start with docs location">
+    Begin by enabling Ask Fern on your documentation site (`location: [docs]`) to test and refine the experience before expanding to other channels like Slack or Discord.
+  </Accordion>
+
+  <Accordion title="Use descriptive titles for datasources">
+    Always provide a `title` for your datasources. This helps users understand the source of information when Ask Fern provides citations.
+  </Accordion>
+
+  <Accordion title="Keep datasources relevant">
+    Only include datasources that contain information relevant to your users' questions. Too many datasources can dilute the quality of search results.
+  </Accordion>
+
+  <Accordion title="Test with previews">
+    Use preview deployments to test your Ask Fern configuration, including locations and datasources, before deploying to production.
+  </Accordion>
+</AccordionGroup>