docs

Author: msukkari

docs/docs.json

@@ -28,13 +28,15 @@
                         "group": "Features",
                         "pages": [
                             {
-                                "group": "Search",
+                                "group": "Code Search",
                                 "pages": [
+                                    "docs/features/search/overview",
                                     "docs/features/search/syntax-reference",
                                     "docs/features/search/multi-branch-indexing",
                                     "docs/features/search/search-contexts"
                                 ]
                             },
+                            "docs/features/ask",
                             "docs/features/code-navigation",
                             "docs/features/analytics",
                             "docs/features/mcp-server",
@@ -66,6 +68,7 @@
                                     "docs/connections/request-new"
                                 ]
                             },
+                            "docs/configuration/language-model-providers",
                             "docs/license-key",
                             "docs/configuration/environment-variables",
                             {

docs/docs/configuration/language-model-providers.mdx

@@ -0,0 +1,4 @@
+---
+title: Language Model Providers
+sidebarTitle: Language model providers
+---

docs/docs/features/ask.mdx

@@ -0,0 +1,46 @@
+---
+title: Ask Sourcebot
+---
+
+Ask Sourcebot gives you the ability to ask complex questions about your codebase in natural language. 
+
+It uses Sourcebot’s existing [code search](/docs/features/search/overview) and [navigation](/docs/features/code-navigation) tools to allow reasoning models to search your code, 
+follow code nav references, and provide an answer that’s rich with inline citations and navigable code snippets.
+
+<CardGroup>
+<Card title="Configure language models" icon="robot" href="/docs/configuration/language-model-providers" horizontal="true">
+    Learn how to connect your language model to Sourcebot
+</Card>
+<Card title="Index repos" icon="book" href="/docs/connections/overview" horizontal="true">
+    Learn how to index your repos so you can ask questions about them
+</Card>
+</CardGroup>
+
+<video
+  autoPlay
+  muted
+  loop
+  playsInline
+  className="w-full aspect-video"
+  src="/images/ask_sourcebot_low_res.mp4"
+></video>
+
+# Why do we need another AI dev tool?
+
+Existing AI dev tools (Cursor, Claude Code, Copilot) are great at generating code. However, we believe one of the hardest parts of being
+a software engineer is **understanding code**. 
+
+In this domain, these tools fall short:
+- You can only ask questions about the code you have checked out locally
+- You get a wall of text that's difficult to parse, requiring you to go back and forth through different code snippets in the response
+- The richness of the explanation is limited by the fact that you're in your IDE
+
+We built Ask Sourcebot to address these problems. With Ask Sourcebot, you can:
+- Ask questions about your teams entire codebase (even on repos you don't have locally) 
+- Easily parse the response with side-by-side citations and code navigation
+- Share answers with your team to spread the knowledge
+
+Being a web app is less convenient than being in your IDE, but it allows Sourcebot to provide responses in a richer UI that isn't constrained by the IDE.
+
+We believe this experience of understanding your codebase is superior, and we hope you find it useful. We'd love to know what you think! Feel free to join the discussion on our
+[GitHub](https://github.com/sourcebot-dev/sourcebot/discussions).

docs/docs/features/search/overview.mdx

@@ -0,0 +1,34 @@
+---
+title: Overview
+---
+
+Search across all your repos/branches across any code host platform. Blazingly fast, and supports regular expressions, repo/language search filters, boolean logic, and more.
+
+<Accordion title="Key benefits">
+- **Regex support:** Use regular expressions to find code with precision.
+- **Query language:** Scope searches to specific files, repos, languages, symbol definitions and more using a rich [query language](/docs/features/search/syntax-reference).
+- **Branch search:** Specify a list of branches to search across ([docs](/docs/features/search/multi-branch-indexing)).
+- **Fast & scalable:** Sourcebot uses [trigram indexing](https://en.wikipedia.org/wiki/Trigram_search), allowing it to scale to massive codebases.
+- **Syntax highlighting:** Syntax highlighting support for over [100+ languages](https://github.com/sourcebot-dev/sourcebot/blob/57724689303f351c279d37f45b6406f1d5d5d5ab/packages/web/src/lib/codemirrorLanguage.ts#L125).
+- **Multi-repository:** Search across all of your repositories in a single search.
+- **Search suggestions:** Get search suggestions as you craft your query.
+- **Filter panel:** Filter results by repository or by language.
+</Accordion>
+
+<CardGroup>
+<Card title="Index repos" icon="book" href="/docs/connections/overview" horizontal="true">
+    Learn how to index your repos so you can ask questions about them
+</Card>
+<Card title="Branches" icon="split" href="/docs/features/search/multi-branch-indexing" horizontal="true">
+    Learn how to index and search through your branches
+</Card>
+</CardGroup>
+
+<video
+  autoPlay
+  muted
+  loop
+  playsInline
+  className="w-full aspect-video"
+  src="https://framerusercontent.com/assets/cEqHNSLiMbNeG3bk5xheQWXmKqc.mp4"
+></video>

docs/docs/overview.mdx

@@ -2,7 +2,10 @@
 title: "Overview"
 ---
 
-[Sourcebot]((https://github.com/sourcebot-dev/sourcebot)) is an open-source, self-hosted code search tool. It allows you to search and navigate across millions of lines of code across several code host platforms.
+[Sourcebot](https://github.com/sourcebot-dev/sourcebot) is a self-hosted tool that helps you understand your codebase. 
+
+- [Code search](/docs/features/search/overview): Search and navigate across all your repos and branches, no matter where they’re hosted
+- [Ask Sourcebot](/docs/features/ask): Ask questions about your codebase and have Sourcebot provide detailed answers grounded with inline citations
 
 <CardGroup>
 <Card title="Deployment guide" icon="server" href="/docs/deployment-guide" horizontal="true">
@@ -30,9 +33,28 @@ title: "Overview"
   Find an overview of all Sourcebot features below. For details, see the individual documentation pages.
 </Info>
 
-### Fast indexed based search
+### Ask Sourcebot
+
+[Ask Sourcebot](/docs/features/ask) gives you the ability to ask complex questions about your codebase, and have Sourcebot provide detailed answers with inline citations.
+
+<Accordion title="Key benefits">
+- **Bring your own model:** [Configure](/docs/configuration/language-model-providers) to any language model you'd like
+- **Inline citations:** Every answer Sourcebot provides is grounded with inline citations directly into your codebase
+- **Mutli-repo:** Ask questions about any repository you have indexed on Sourcebot
+</Accordion>
+
+<video
+  autoPlay
+  muted
+  loop
+  playsInline
+  className="w-full aspect-video"
+  src="/images/ask_sourcebot_low_res.mp4"
+></video>
+
+### Code Search
 
-Search across millions of lines of code instantly using Sourcebot's blazingly fast indexed search. Find exactly what you are looking for with regular expressions, search filters, boolean logic, and more.
+Search across all your repos/branches across any code host platform. Blazingly fast, and supports regular expressions, repo/language search filters, boolean logic, and more.
 
 <Accordion title="Key benefits">
 - **Regex support:** Use regular expressions to find code with precision.