merge main

Author: msukkari

docs/docs/connections/overview.mdx

@@ -41,18 +41,35 @@ A JSON configuration file is used to specify connections. For example:
 }
 ```
 
-Configuration files must conform to the [JSON schema](https://raw.githubusercontent.com/sourcebot-dev/sourcebot/main/schemas/v3/index.json).
+Configuration files must conform to the [JSON schema](#schema-reference).
 
-When running Sourcebot, this file must be mounted in a volume that is accessible to the container, with it's path specified in the `CONFIG_FILE` environment variable. For example:
+When running Sourcebot, this file must be mounted in a volume that is accessible to the container, with it's path specified in the `CONFIG_PATH` environment variable. For example:
 
 ```bash
 docker run \
     -v $(pwd)/config.json:/data/config.json \
-    -e CONFIG_FILE=/data/config.json \
+    -e CONFIG_PATH=/data/config.json \
     ... \ # other config
     ghcr.io/sourcebot-dev/sourcebot:latest
 ```
 
+Sourcebot performs syncing in the background. Syncing consists of two steps:
+1. Fetch the latest changes from `HEAD` (and any [additional branches](/docs/features/search/multi-branch-indexing)) from the code host.
+2. Re-indexes the repository.
+
+This is processed in a [job queue](/docs/overview#architecture), and is parallelized across multiple worker processes. Jobs will take longer to complete the first time a repository is synced, or when a diff is large.
+
+On the home page, you can view the sync status of ongoing jobs:
+
+<video
+    autoPlay
+    muted
+    loop
+    playsInline
+    className="w-full aspect-video"
+    src="https://framerusercontent.com/assets/7YyxK8ctPEy9Rf68X2kIdMI.mp4"
+></video>
+
 ## Getting started
 ---
 

docs/docs/deployment-guide.mdx

@@ -79,13 +79,17 @@ Watch this 1:51 minute video to get a quick overview of how to deploy Sourcebot
 
     </Step>
 
-    <Step title="Done">
-        You're all set! Navigate to `http://localhost:3000` to login and start searching.
+    <Step title="Login">
+        Navigate to `http://localhost:3000` and create an account. The first account which is registered on a fresh Sourcebot deployment is given the [owner role](/docs/configuration/auth/roles-and-permissions).
 
         <Note>
-            The first account which is registered on a fresh Sourcebot deployment is given the [owner role](/docs/configuration/auth/roles-and-permissions).
+            By default, only email / password authentication is enabled. [Learn more about authentication](/docs/configuration/auth/overview).
         </Note>
     </Step>
+
+    <Step title="Done">
+        You're all set! You can now start searching - checkout the [syntax guide](/docs/features/search/syntax-reference) to learn more about how to search.
+    </Step>
 </Steps>
 
 ## Next steps

docs/docs/license-key.mdx

@@ -27,7 +27,7 @@ docker run \
 
 | Feature | OSS | Licensed |
 |:---------|:-----|:----------|
-| [Search](/docs/features/search/overview) | ✅ | ✅ |
+| [Search](/docs/features/search/syntax-reference) | ✅ | ✅ |
 | [Full code host support](/docs/connections/overview) | ✅ | ✅ |
 | [MCP Server](/docs/features/mcp-server) | ✅ | ✅ | 
 | [Agents](/docs/features/agents/overview) | ✅ | ✅ |

docs/docs/overview.mdx

@@ -21,9 +21,9 @@ title: "Overview"
   Find an overview of all Sourcebot features below. For details, see the individual documentation pages.
 </Info>
 
-### Fast-indexed based search
+### Fast indexed based search
 
-Search across millions of lines of code in seconds 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 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.
 
 <Accordion title="Key benefits">
 - **Regex support:** Use regular expressions to find code with precision.
@@ -71,8 +71,8 @@ Search across millions of lines of code in seconds using Sourcebot's blazingly f
 Connect your code from multiple code-host platforms and search across all of them from a single interface.
 
 <Accordion title="Key benefits">
-- **Auto re-syncing:** Code-hosts will periodically sync with Sourcebot to pull the latest changes.
-- **Flexible configuration:** Sourcebot uses a expressive [JSON schema](/docs/connections/overview) config format to specify exaclty what repositories to index (and what not to index).
+- **Auto re-syncing:** Sourcebot will periodically sync with code hosts to pull the latest changes.
+- **Flexible configuration:** Sourcebot uses an expressive [JSON schema](/docs/connections/overview) config format to specify exactly what repositories to index (and what not to index).
 - **Parallel indexing:** Repositories are indexed in parallel.
 </Accordion>