feedback

Author: brendan-kellam

docs/docs/connections/overview.mdx

@@ -41,7 +41,7 @@ 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:
 
@@ -53,6 +53,23 @@ docker run \
     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/syntax-guide) to learn more about how to search.
+    </Step>
 </Steps>
 
 ## Next steps

docs/docs/overview.mdx

@@ -71,7 +71,7 @@ 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.
+- **Auto re-syncing:** Sourcebot will periodically sync with code hosts 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).
 - **Parallel indexing:** Repositories are indexed in parallel.
 </Accordion>

packages/web/src/features/entitlements/server.ts

@@ -55,7 +55,6 @@ export const getPlan = (): Plan => {
 
         return licenseKey.seats === SOURCEBOT_UNLIMITED_SEATS ? "self-hosted:enterprise-unlimited" : "self-hosted:enterprise";
     } else {
-        console.info(`No valid license key found. Falling back to oss plan.`);
         return "oss"; 
     }
 }