docs

Author: brendan-kellam

docs/docs.json

@@ -46,6 +46,7 @@
                                 "group": "Ask Sourcebot",
                                 "pages": [
                                     "docs/features/ask/overview",
+                                    "docs/features/ask/chat-sharing",
                                     "docs/features/ask/add-model-providers"
                                 ]
                             },

docs/docs/features/ask/chat-sharing.mdx

@@ -0,0 +1,66 @@
+---
+title: Chat Sharing
+---
+
+Chat sharing allows you to share Ask Sourcebot conversations with others. Whether you want to share insights with your team or make a conversation publicly accessible, Sourcebot provides flexible sharing options.
+
+<Frame>
+  <img src="/images/chat-sharing-dialog.png" alt="Chat sharing dialog" />
+</Frame>
+
+## Visibility Options
+
+Every chat has a visibility setting that controls who can access it:
+
+<Frame>
+  <img src="/images/chat-visibility-dropdown.png" alt="Chat visibility dropdown" />
+</Frame>
+
+### Private (Default)
+- Only the chat owner can view the conversation
+- Other users cannot access the chat, even with the link
+- You can explicitly invite specific org members to view the chat (requires [Enterprise license](/docs/license-key))
+
+### Public
+- Anyone with the link can view the conversation
+- If [anonymous access](/docs/configuration/auth/access-settings) is enabled, no authentication is required to view
+- Useful for sharing insights with your team or creating reference documentation
+- Public chats can be duplicated by others
+
+## Sharing with Specific Users
+
+<Note>Sharing with specific users requires an [Enterprise license](/docs/license-key).</Note>
+
+<Frame>
+  <img src="/images/chat-invite-users.png" alt="Invite users dialog" />
+</Frame>
+
+Chat owners can invite specific organization members to view their private chats:
+
+1. Open the chat you want to share
+2. Click the **Share** button in the top-right corner
+3. Search for users by name or email
+4. Select the users you want to invite
+5. Click **Invite** to grant them access
+
+Invited users will be able to:
+- View the full conversation
+- See all messages and code citations
+- Navigate through referenced code snippets
+
+Invited users **cannot**:
+- Edit or delete the chat
+- Send new messages
+- Invite other users
+
+### Removing Access
+
+<Frame>
+  <img src="/images/chat-remove-user.png" alt="Remove user from chat" />
+</Frame>
+
+To remove a user's access to your chat:
+
+1. Open the Share dialog
+2. Find the user in the "People with access" list
+3. Click the **X** button next to their name

docs/images/chat-invite-users.png

@@ -15,6 +15,7 @@ import { Separator } from "@/components/ui/separator";
 import { cn } from "@/lib/utils";
 import placeholderAvatar from "@/public/placeholder_avatar.png";
 import { ChatVisibility } from "@sourcebot/db";
+import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
 import { Info, Link2Icon, Loader2, Lock, X } from "lucide-react";
 import Link from "next/link";
 import { usePathname } from "next/navigation";
@@ -130,27 +131,32 @@ export const ShareSettings = ({
                                             )}
                                         </div>
                                     </div>
-                                    <Button
-                                        variant="ghost"
-                                        size="icon"
-                                        className="h-8 w-8 text-muted-foreground hover:text-foreground"
-                                        disabled={removingUserIds.has(user.id)}
-                                        onClick={async () => {
-                                            setRemovingUserIds(prev => new Set(prev).add(user.id));
-                                            await onRemoveSharedWithUser(user.id);
-                                            setRemovingUserIds(prev => {
-                                                const next = new Set(prev);
-                                                next.delete(user.id);
-                                                return next;
-                                            });
-                                        }}
-                                    >
-                                        {removingUserIds.has(user.id) ? (
-                                            <Loader2 className="h-4 w-4 animate-spin" />
-                                        ) : (
-                                            <X className="h-4 w-4" />
-                                        )}
-                                    </Button>
+                                    <Tooltip>
+                                        <TooltipTrigger asChild>
+                                            <Button
+                                                variant="ghost"
+                                                size="icon"
+                                                className="h-8 w-8 text-muted-foreground hover:text-foreground"
+                                                disabled={removingUserIds.has(user.id)}
+                                                onClick={async () => {
+                                                    setRemovingUserIds(prev => new Set(prev).add(user.id));
+                                                    await onRemoveSharedWithUser(user.id);
+                                                    setRemovingUserIds(prev => {
+                                                        const next = new Set(prev);
+                                                        next.delete(user.id);
+                                                        return next;
+                                                    });
+                                                }}
+                                            >
+                                                {removingUserIds.has(user.id) ? (
+                                                    <Loader2 className="h-4 w-4 animate-spin" />
+                                                ) : (
+                                                    <X className="h-4 w-4" />
+                                                )}
+                                            </Button>
+                                        </TooltipTrigger>
+                                        <TooltipContent side="bottom">Remove user</TooltipContent>
+                                    </Tooltip>
                                 </div>
                             ))}
                         </div>
@@ -204,9 +210,10 @@ export const ShareSettings = ({
             )}
             <Separator className="-mx-4 w-auto my-4" />
             <div className="flex justify-between items-center">
-                {/* @todo: link to docs */}
                 <Link
-                    href="#"
+                    href="https://docs.sourcebot.dev/docs/features/ask/chat-sharing"
+                    target="_blank"
+                    rel="noopener noreferrer"
                     className="flex items-center gap-1.5 text-sm text-muted-foreground hover:text-foreground transition-colors"
                 >
                     <Info className="h-4 w-4" />