Merge branch 'main' into kafka_restructure

Author: Blargian

.gitignore

@@ -62,6 +62,7 @@ docs/getting-started/index.md
 docs/data-modeling/projections/index.md
 docs/cloud/manage/jan2025_faq/index.md
 docs/chdb/guides/index.md
+docs/use-cases/AI_ML/index.md
 
 .vscode
 .aspell.en.prepl

README.md

@@ -18,19 +18,19 @@
 
 ClickHouse is blazing fast, but understanding ClickHouse and using it effectively is a journey. The documentation is your source for gaining the knowledge you need to be successful with your ClickHouse projects and applications. [Head over to clickhouse.com/docs to learn more →](https://clickhouse.com/)
 
-## Table of contents {#table-of-contents}
+## Table of contents
 
 - [About this repo](#about-this-repo)
 - [Run locally](#run-locally)
 - [Contributing](#contributing)
 - [Issues](#issues)
 - [License](#license)
 
-## About this repo {#about-this-repo}
+## About this repo
 
 This repository manages the documentation for [ClickHouse](https://clickhouse.com/docs). The content is built with [Docusaurus](https://docusaurus.io/) and hosted on [Vercel](https://vercel.com). Documentation content is written in Markdown and is held in the `/docs` directory.
 
-## Run locally {#run-locally}
+## Run locally
 
 You can run a copy of this website locally within a few steps. Some folks find this useful when contributing so they can see precisely what their changes will look like on the production site.
 
@@ -116,23 +116,19 @@ To check spelling and markdown is correct locally run:
 yarn check-style
 ```
 
-### Notes {#notes}
+### Notes
 
 Here are some things to keep in mind when building a local copy of the ClickHouse docs site.
 
-#### Build-time {#build-time}
-
-Due to the complex structure of this repo, the docs site can take some time to build locally. As a benchmark, it takes ~3 minutes to build on an M1 Macbook with 8GB RAM.
-
-#### Redirects {#redirects}
+#### Redirects
 
 Due to how the local server is built, redirects will not work. For example, visiting `clickhouse.com/docs` on the production site will lead you to `clickhouse.com/docs/intro`. However, on a local copy of the site, you will see a 404 page if you try to visit `localhost:8000/docs`.
 
-## Contributing {#contributing}
+## Contributing
 
 Want to help out? Contributions are always welcome! If you want to help out but aren't sure where to start, check out the [issues board](https://github.com/clickhouse/clickhouse-docs/issues).
 
-### Pull requests {#pull-requests}
+### Pull requests
 
 Please assign any pull request (PR) against an issue; this helps the docs team track who is working on what and what each PR is meant to address. If there isn't an issue for the specific _thing_ you want to work on, quickly create one and comment so that it can be assigned to you. One of the repository maintainers will add you as an assignee.
 

docs/about-us/beta-and-experimental-features.md

@@ -22,7 +22,7 @@ The sections below explicitly describe the properties of **Beta** and **Experime
 - Possibly enabled in ClickHouse Cloud
 - The ClickHouse team supports beta features
 
-The following features are considered Beta in ClickHouse Cloud and are available for use in ClickHouse Cloud Services, even though they may be currently under a ClickHouse SETTING named ```allow_experimental_*```:
+You can find below the features considered Beta in ClickHouse Cloud and are available for use in your ClickHouse Cloud Services.
 
 Note: please be sure to be using a current version of the ClickHouse [compatibility](/operations/settings/settings#compatibility) setting to be using a recently introduced feature.
 

docs/cloud/changelogs/24_02.md

@@ -4,7 +4,7 @@ title: 'v24.2 Changelog'
 description: 'Fast release changelog for v24.2'
 keywords: ['changelog']
 sidebar_label: '24.2'
-sidebar_position: 7
+sidebar_position: 8
 ---
 
 ### ClickHouse release tag: 24.2.2.15987 {#clickhouse-release-tag-242215987}

docs/cloud/changelogs/24_05.md

@@ -4,7 +4,7 @@ title: 'v24.5 Changelog for Cloud'
 description: 'Fast release changelog for v24.5'
 keywords: ['changelog', 'cloud']
 sidebar_label: '24.5'
-sidebar_position: 6
+sidebar_position: 7
 ---
 
 # v24.5 Changelog for Cloud

docs/cloud/changelogs/24_06.md

@@ -4,7 +4,7 @@ title: 'v24.6 Changelog for Cloud'
 description: 'Fast release changelog for v24.6'
 keywords: ['changelog', 'cloud']
 sidebar_label: '24.6'
-sidebar_position: 5
+sidebar_position: 6
 ---
 
 # v24.6 Changelog for Cloud

docs/cloud/changelogs/24_08.md

@@ -4,7 +4,7 @@ title: 'v24.8 Changelog for Cloud'
 description: 'Fast release changelog for v24.8'
 keywords: ['changelog', 'cloud']
 sidebar_label: '24.8'
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 Relevant changes for ClickHouse Cloud services based on the v24.8 release.

docs/cloud/changelogs/24_10.md

@@ -4,7 +4,7 @@ title: 'v24.10 Changelog for Cloud'
 description: 'Fast release changelog for v24.10'
 keywords: ['changelog', 'cloud']
 sidebar_label: '24.10'
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 Relevant changes for ClickHouse Cloud services based on the v24.10 release.

docs/cloud/changelogs/24_12.md

@@ -4,7 +4,7 @@ title: 'v24.12 Changelog for Cloud'
 description: 'Fast release changelog for v24.12'
 keywords: ['changelog', 'cloud']
 sidebar_label: '24.12'
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 Relevant changes for ClickHouse Cloud services based on the v24.12 release.

docs/cloud/changelogs/25_04.md

@@ -4,7 +4,7 @@ title: 'v25.4 Changelog for Cloud'
 description: 'Fast release changelog for v25.4'
 keywords: ['changelog', 'cloud']
 sidebar_label: '25.4'
-sidebar_position: 1
+sidebar_position: 2
 ---
 
 ## Backward Incompatible Changes {#backward-incompatible-changes}