Merge branch 'main' into al/fix-sslmode-docs

Author: Chickensoupwithrice

README.md

@@ -1,6 +1,6 @@
 # Sourcegraph Docs
 
-<!-- Working branch for JAN 2025 Release -->
+<!-- Working branch for FEB 2025 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.
 

baseai/memory/docs/index.ts

@@ -1,16 +1,16 @@
 import { MemoryI } from '@baseai/core';
 
 const memoryDocs = (): MemoryI => ({
-  name: 'docs',
-  description: 'Docs folder of sourcegraph docs repository as an auto-synced memory',
+	name: 'docs',
+	description: 'Docs folder of sourcegraph docs repository as an auto-synced memory',
 	git: {
 		enabled: true,
-		include: ['**/*'],
+		include: ['**/*.mdx'],
 		gitignore: true,
-		deployedAt: '',
-		embeddedAt: '',
+		deployedAt: '39f2778ad2dce348bb762a85f765c21453cec4fe',
+		embeddedAt: ''
 	},
-  documents: {
+	documents: {
 		meta: doc => {
 			const url = `https://sourcegraph.com/docs/${doc.path}`;
 			return {

docs.config.js

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

docs/admin/code_hosts/gerrit.mdx

@@ -21,8 +21,8 @@ A Gerrit instance can be connected to Sourcegraph as follows:
 ```json
 {
   "url": "https://gerrit.example.com/", // Be sure to add a trailing slash
-  "username": "<admin username>",
-  "password": "<admin password>",
+  "username": "<username>",
+  "password": "<password>",
   "projects": [ // If not set, all projects on the Gerrit instance will be mirrored
     "docs",
     "kubernetes/kubernetes"
@@ -33,15 +33,34 @@ A Gerrit instance can be connected to Sourcegraph as follows:
   "authorization": {} // Marks all repositories as private. Users will be required to present valid Gerrit HTTP credentials in order to view repositories
 }
 ```
-4. The provided `username` and `password` must be the HTTP credentials of an admin account on Gerrit. See [the Gerrit HTTP documentation](https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.2/user-upload.html#http) for details on how to generate HTTP credentials.
-<Callout type="note">The Gerrit instance has to have HTTPS clones enabled (the default). [`download.scheme=http`](https://gerrit-review.googlesource.com/Documentation/config-gerrit.html#download). Sourcegraph cannot clone Gerrit repos via SSH.</Callout>
+4. The provided `username` and `password` must be the HTTP credentials of an account on Gerrit that has access to all the repositories that need to be cloned. See [the Gerrit HTTP documentation](https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.2/user-upload.html#http) for details on how to generate HTTP credentials.
 5. Select **Add Repositories** to create the connection. Sourcegraph will start mirroring the specified projects.
 
 If you added the `"authorization": {}` option to the configuration, and this is the first Gerrit code host connection you have created for this Gerrit instance, you might see a warning like this:
 ![Warning indicating that an authentication provider is required for a code host connection](https://storage.googleapis.com/sourcegraph-assets/docs/images/administration/config/external-services/gerrit/gerrit-auth-warning.png)
 
 Simply follow the steps in the next section to configure a Gerrit authentication provider.
 
+### Clone using SSH
+
+To clone using SSH, provide `"gitSSHCredential"` in the configuration:
+
+```json
+{
+  "url": "https://gerrit.example.com/",
+  "username": "<username>",
+  "password": "<password>",
+  "projects": [
+    "docs",
+    "kubernetes/kubernetes"
+  ],
+  "gitSSHCredential": {
+    "privateKey": "..." // base64 encoded private key that will be used for cloning
+  },
+  "authorization": {}
+}
+```
+
 ## Add Gerrit as an authentication provider
 
 If the `"authorization": {}` option has been set on a Gerrit code host connection, a Gerrit authentication provider will be required so that authroized users are able to search for and browse the code mirrored by that code host connection.

docs/admin/code_hosts/github.mdx

@@ -1,5 +1,9 @@
 # GitHub
 
+<TierCallout>
+  Supported on all Sourcegraph [pricing](https://sourcegraph.com/pricing) plans.
+</TierCallout>
+
 Site admins can sync Git repositories hosted on [GitHub.com](https://github.com) and [GitHub Enterprise](https://enterprise.github.com) with Sourcegraph so that users can search and navigate the repositories.
 
 There are 2 ways to connect with GitHub:

docs/admin/code_hosts/gitlab.mdx

@@ -1,5 +1,9 @@
 # GitLab
 
+<TierCallout>
+  Supported on Sourcegraph [Free](/pricing/free) and [Enterprise](/pricing/enterprise) plans.
+</TierCallout>
+
 Site admins can sync Git repositories hosted on [GitLab](https://gitlab.com) (GitLab.com and GitLab CE/EE) with Sourcegraph so that users can search and navigate the repositories.
 
 To connect GitLab to Sourcegraph:

docs/admin/code_hosts/index.mdx

@@ -1,5 +1,7 @@
 # Code host connections
 
+<Callout type="info">Sourcegraph Enterprise Starter supports only GitHub as a code host connection. Enterprise plan can connect to all supported code hosts listed on this page.</Callout>
+
 Sourcegraph can sync repositories from code hosts and other similar services. We designate code hosts between Tier 1 and Tier 2 based on Sourcegraph's capabilities when used with those code hosts.
 
 ## Tier 1 code hosts