Merge branch 'main' into edueng-614-validate-branch-existence

Author: ebembi-crdb

StyleGuide.md

@@ -13,6 +13,7 @@ Included in this guide:
   - [CockroachDB products](#cockroachdb-products)
   - [CockroachDB versions](#cockroachdb-versions)
   - [Third-party products](#third-party-products)
+  - [AI](#ai)
 - [Inclusivity](#inclusivity)
   - [Avoid ableist language](#avoid-ableist-language)
   - [Avoid unnecessarily gendered language](#avoid-unnecessarily-gendered-language)
@@ -219,6 +220,19 @@ Use **on a cluster** when referring to workloads, services, or databases that ru
 - Databases on the cluster
 - Jobs running on the cluster
 
+### AI
+
+Write "AI" without periods. Not "A.I."
+
+You don't need to precede the usage of the term "AI" with its elaboration (e.g. "Artificial Intelligence (AI).") Any reader will know what AI is.
+
+When describing "AI tools," "AI agents," or "AI assistants" (etc.) in the context of integrating with CockroachDB, precede introductory instances of these terms with the word "your."
+
+  - **Avoid:** The MCP server enables AI tools to access a cluster.
+  - **Prefer:** The MCP server enables your AI tools to access a cluster.
+
+This is a request from Cockroach Labs' legal team. The idea is to remind the reader that these tools are not Cockroach Labs', and so any mistaken/detrimental use of these tools is not Cockroach Labs' responsibility. Not every instance of these terms needs to be preceded with the word "your." This is mainly meant for early instances of these terms on the page (i.e. in introductory paragraphs), to establish this idea.
+
 ## Inclusivity
 
 Use inclusive language that reflects a diverse readership. Avoid terms that inherently exclude, stereotype, or cause confusion.

src/current/_config_cockroachdb.yml

@@ -4,4 +4,4 @@ destination: _site/docs
 homepage_title: CockroachDB Docs
 versions:
   stable: v26.1
-  dev: v26.1
+  dev: v26.2

src/current/_data/cards.yml

@@ -8,23 +8,14 @@ develop:
   - link: "/PREFIX/connect-to-the-database.html"
     title: "Connect to a cluster"
     text: "Get details on how to connect to a CockroachDB cluster using your favorite language and framework."
-  - link: "/PREFIX/example-apps.html"
-    title: "Example applications"
-    text: "Browse our example applications written in your favorite language and framework."
-  - link: "/PREFIX/example-apps.html"
-    title: "Tutorials"
-    text: "Browse our tutorials."
   - link: "/PREFIX/developer-basics.html"
     title: "Developer basics"
     text: "A quick overview of key concepts developers need to know about CockroachDB."
     text: "Submit SQL queries to retrieve data from your cluster."
   - link: "/PREFIX/schema-design-overview.html"
     title: "Design a schema"
     text: "Details and best practices about designing schemas for your data."
-  - link: "/PREFIX/query-data.html"
-    title: "Read data"
-    text: "How to query your cluster to retrieve data."
-  - link: "/PREFIX/insert-data.html"
+  - link: "/PREFIX/insert.html"
     title: "Write data"
     text: "How to insert data into your cluster."
   - link: "/PREFIX/query-behavior-troubleshooting.html"

src/current/_data/redirects.yml

@@ -422,7 +422,7 @@
     - show-transaction.md
   versions: [':version']
 
-- destination: stable/example-apps.md#python
+- destination: stable/build-a-python-app-with-cockroachdb-psycopg3
   sources:
     - v20.1/build-a-python-app-with-cockroachdb-pony.md
 
@@ -1073,11 +1073,88 @@
   sources: ['cockroachcloud/learn-cockroachdb-sql.md']
 
 - destination: cockroachcloud/client-certs-advanced.md
-  sources: ['v26.1/security-reference/config-secure-hba.md', 'stable/security-reference/config-secure-hba.md']
+  sources: ['v26.1/security-reference/config-secure-hba.md', 'stable/security-reference/config-secure-hba.md', 'v26.2/security-reference/config-secure-hba.md']
 
 - destination: cockroachdb-operator-overview.md
   sources: ['orchestrate-a-local-cluster-with-kubernetes.md', 'orchestrate-a-local-cluster-with-kubernetes-insecure.md']
-  versions: ['v26.1']
+  versions: ['v26.1', 'v26.2']
 
+- destination: deploy-cockroachdb-on-premises.md
+  sources: ['deploy-cockroachdb-on-premises-insecure.md']
+  versions: ['v26.1', 'v26.2']
 
+- destination: deploy-cockroachdb-on-aws.md
+  sources: ['deploy-cockroachdb-on-aws-insecure.md']
+  versions: ['v26.1', 'v26.2']
 
+- destination: deploy-cockroachdb-on-microsoft-azure.md
+  sources: ['deploy-cockroachdb-on-microsoft-azure-insecure.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: deploy-cockroachdb-on-google-cloud-platform.md
+  sources: ['deploy-cockroachdb-on-google-cloud-platform-insecure.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: deploy-cockroachdb-on-digital-ocean.md
+  sources: ['deploy-cockroachdb-on-digital-ocean-insecure.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: stable/developer-guide-overview.md
+  sources: ['cockroachcloud/deploy-a-python-to-do-app-with-flask-kubernetes-and-cockroachcloud.md']
+
+- destination: developer-guide-overview.md
+  sources: ['example-apps.md', 'build-a-spring-app-with-cockroachdb-jdbc.md', 'build-a-spring-app-with-cockroachdb-jpa.md', 'movr-flask-use-case.md', 'movr-flask-database.md', 'movr-flask-setup.md', 'movr-flask-application.md', 'movr-flask-deployment.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: topology-patterns.md
+  sources: ['topology-development.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: monitoring-and-alerting.md
+  sources: ['datadog.md', 'dbmarlin.md', 'kibana.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: schema-design-overview.md
+  sources: ['schema-design-database.md', 'schema-design-schema.md', 'schema-design-table.md', 'schema-design-update.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: reads-and-writes-overview.md
+  sources: ['query-data.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: cockroachcloud/overview-page.md
+  sources: ['cockroachcloud/cluster-overview-page.md']
+
+- destination: releases/index.md
+  sources: ['releases/staged-release-process.md']
+  
+- destination: releases/downloads-archive.md
+  sources: ['releases/unsupported-versions.md']
+
+- destination: delete.md
+  sources: ['delete-data.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: configure-replication-zones.md
+  sources: ['demo-automatic-cloud-migration.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: jsonb.md
+  sources: ['demo-json-support.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: query-spatial-data.md
+  sources: ['export-spatial-data.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: insert.md
+  sources: ['insert-data.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: spatial-data-overview.md
+  sources: ['spatial-tutorial.md', 'geoserver.md']
+  versions: ['v26.1', 'v26.2']
+
+- destination: update.md
+  sources: ['update-data.md']
+  versions: ['v26.1', 'v26.2']