Merge branch 'main' into upgrade

Author: zahidalidev

README.md

@@ -1,6 +1,6 @@
 # Sourcegraph Docs
 
-<!-- Working branch for JAN 2025 Release -->
+<!-- Working branch for SG 6.3 Release -->
 
 Welcome to the Sourcegraph documentation! We're excited to have you contribute to our docs. We've recently rearchitectured our docs tech stack — powered by Next.js, TailwindCSS and deployed on Vercel. This guide will walk you through the process of contributing to our documentation using the new tech stack.
 
@@ -18,7 +18,7 @@ Navigate to the project directory by typing the following command in your termin
 cd sourcegraph-docs
 ```
 
-Before the dependencies are install make sure your local machine has the following versions of `node` and `pnpm`:
+Before the dependencies are install make sure your local machine has the following versions of `node` and `pnpm` installed:
 
 * node: `v20.8.1`
 * pnpm: `8.13.1`
@@ -148,11 +148,10 @@ As you make changes to the documentation, the development server will automatica
 
 ### Previewing Vercel Deployments
 
-When you open a PR Vercel deploys and provides you with a preview deployment link. To view your deployment, click the "Visit Preview" and then append `/docs` at the end of the URL. The original link gives you a `404`.
+When you open a PR Vercel deploys and provides you with a preview deployment link. To view your deployment, click the **Visit Preview** link from Vercel's deployment panel in your PRs and you get a preview of your docs
 
 ![CleanShot 2024-11-05 at 10 11 29@2x](https://github.com/user-attachments/assets/b0911e2e-95a7-4f56-b2ff-b659d13077d8)
 
-
 ## Submitting your Contribution
 
 Once you're satisfied with your changes, follow these steps:

baseai/memory/docs/index.ts renamed to baseai/memory/memory-sg-docs-live/index.ts

@@ -1,14 +1,14 @@
 import { MemoryI } from '@baseai/core';
 
 const memoryDocs = (): MemoryI => ({
-	name: 'docs',
-	description: 'Docs folder of sourcegraph docs repository as an auto-synced memory',
+	name: 'memory-sg-docs-live',
+	description: 'An AI memory storing all Sourcegraph docs.',
 	git: {
 		enabled: true,
 		include: ['**/*.mdx'],
 		gitignore: true,
-		deployedAt: '39f2778ad2dce348bb762a85f765c21453cec4fe',
-		embeddedAt: ''
+		embeddedAt: '',
+		deployedAt: '1b67d5c14520a898e2b9933ab3d2a9fe28515e31'
 	},
 	documents: {
 		meta: doc => {
@@ -22,3 +22,6 @@ const memoryDocs = (): MemoryI => ({
 });
 
 export default memoryDocs;
+
+// Old
+// deployedAt: '5f3fec8530280d01a783aadcdeb0ccc3f9cd8b70',

contentlayer.config.ts

@@ -1,5 +1,3 @@
-/* eslint-disable */
-
 import { defineDocumentType, makeSource } from 'contentlayer/source-files';
 import fs from 'fs';
 import rehypeAutolinkHeadings from 'rehype-autolink-headings';

docs-chatbot.md

@@ -0,0 +1,19 @@
+# How we use Docs Chatbot?
+
+Contact the docs team for any more questions on this.
+
+## To sync all the latest docs changes in the `main` branch check out to the `main` branch and run
+
+```sh
+pnpm langbase-sync
+```
+
+This will verify all the changes since the last sync, update these files, and then write the commit hash to `baseai/memory/docs/index.ts` file which you should commit to keep track.
+
+### Update llms.txt file
+
+Run the following command to update the `llms.txt` file:
+
+```sh
+pnpm llmstxt
+```

docs.config.js

@@ -1,5 +1,5 @@
 const config = {
-	DOCS_LATEST_VERSION: '6.0'
+	DOCS_LATEST_VERSION: '6.3'
 };
 
 module.exports = config;

docs/admin/access_control/index.mdx

@@ -1,5 +1,12 @@
 # Access control
 
+<TierCallout>
+  Supported on [Enterprise](/pricing/enterprise) plans.
+  <user>
+    Available via the Web app.
+  </user>
+</TierCallout>
+
 <Callout type="info">This feature is in Beta stage.</Callout>
 
 > NOTE: This page refers to in-product permissions, which determine who can, for example, create a batch change, or who is a site admin. This is *not* the same as [repository permissions](/admin/permissions/), which enforces the same repository access on Sourcegraph as your code host.

docs/admin/analytics.mdx

@@ -1,5 +1,12 @@
 # Analytics
 
+<TierCallout>
+  Supported on [Enterprise](/pricing/enterprise) plans.
+  <user>
+    Available via the Web app.
+  </user>
+</TierCallout>
+
 The analytics section helps Sourcegraph administrators understand user engagement across the various Sourcegraph features, identify power users, and convey value to internal leaders. Introduced in version 3.42, the section includes analytics breakdowns for our most common features such as Batch Changes, Search Notebooks and search, while also providing basic user-level analytics.
 
 ## Data Visualizations

docs/admin/architecture.mdx

@@ -1,5 +1,12 @@
 # User authentication
 
+<TierCallout>
+  Supported on [Enterprise](/pricing/enterprise) plans.
+  <user>
+    Available via the Web app.
+  </user>
+</TierCallout>
+
 In order to use a Sourcegraph instance, users need an account on the instance. Accounts are used to store settings and preferences, but also to identify a person to make decisions about repository visibility.
 
 For that, various authentication providers can be configured. Multiple options can be provided.
@@ -49,8 +56,7 @@ order:
   use the [OpenID Connect provider](#openid-connect).
 - If you wish to use LDAP and cannot use the GitHub/GitLab OAuth provider as described above, or if
   you wish to use another authentication mechanism that is not yet supported, please [contact
-  us](https://github.com/sourcegraph/sourcegraph/issues/new?template=feature_request) (we respond
-  promptly).
+  us](https://sourcegraph.com/contact)
 
 Most users will use only one auth provider, but you can use multiple auth providers if desired to
 enable sign-in via multiple services. Identities from different providers will be mapped to a

docs/admin/auth/index.mdx

@@ -1,19 +1,20 @@
-# Configuring SAML with Microsoft Entra ID
+# Configuring SAML with Microsoft Entra ID 
+<Callout type="note">Formerly known as Azure Active Directory, or Azure AD.</Callout>
 
 ## 1. Add an unlisted (non-gallery) application to your Microsoft Entra ID organization
 
 1. In Microsoft Entra ID, create an unlisted (non-gallery) application [following the official documentation](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/add-non-gallery-app).
-1. Once the application is created, follow [these instructions to enable SAML SSO](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/configure-single-sign-on-non-gallery-applications). Use these configuration values (replacing "sourcegraph.example.com" with your Sourcegraph instance URL):
-  * **Identifier (Entity ID):** `https://sourcegraph.example.com/.auth/saml/metadata`
-  * **Reply URL (Assertion Consumer Service URL):** `https://sourcegraph.example.com/.auth/saml/acs`
-  * **Sign-on URL, Relay State, and Logout URL** can be left empty.
-  * **User Attributes & Claims:** Add the following attributes.
-    - `emailaddress`: user.mail (required)
-    - `name`: user.userprincipalname (optional)
-    - `login`: user.userprincipalname (optional)
-  * **Name ID**: `email`
-  * You can leave the other configuration values set to their defaults.
-1. Record the value of the "App Federation Metadata Url". You'll need this in the next section.
+2. Once the application is created, follow [these instructions to enable SAML SSO](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/configure-single-sign-on-non-gallery-applications). Use these configuration values (replacing "sourcegraph.example.com" with your Sourcegraph instance URL):
+    * **Identifier (Entity ID):** `https://sourcegraph.example.com/.auth/saml/metadata`
+    * **Reply URL (Assertion Consumer Service URL):** `https://sourcegraph.example.com/.auth/saml/acs`
+    * **Sign-on URL, Relay State, and Logout URL** can be left empty.
+    * **User Attributes & Claims:** Add the following attributes.
+      - `emailaddress`: user.mail (required)
+      - `name`: user.userprincipalname (optional)
+      - `login`: user.userprincipalname (optional)
+    * **Name ID**: `email`
+    * You can leave the other configuration values set to their defaults.
+3. Record the value of the "App Federation Metadata Url". You'll need this in the next section.
 
 ## 2. Add the SAML auth provider to Sourcegraph site config
 
@@ -33,4 +34,4 @@
 }
 ```
 
-> NOTE: Optional, but recommended: [add automatic provisioning of users with SCIM](/admin/scim).
+<Callout type="note">Recommended: [add automatic provisioning of users with SCIM](/admin/scim).</Callout>