Merge branch 'main' into update_clusters_tutorial

Author: Blargian

.gitignore

@@ -55,6 +55,15 @@ static/knowledgebase_toc.json
 .frontmatter-validation-failed
 logs/
 
+# Landing page files with autogenerated table of contents
+docs/cloud/reference/release-notes-index.md
+docs/cloud/manage/api/api-reference-index.md
+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
 *.md.bak
@@ -69,3 +78,4 @@ docs/whats-new/changelog/index.md
 docs/cloud/manage/api/api-reference-index.md
 docs/getting-started/index.md
 docs/data-modeling/projections/index.md
+docs/integrations/data-ingestion/clickpipes/kafka/index.md

README.md

@@ -1,6 +1,6 @@
 <div align=center>
 
-![Website](https://img.shields.io/website?up_message=AVAILABLE&down_message=DOWN&url=https%3A%2F%2Fclickhouse.com%2Fdocs&style=for-the-badge)
+[![Website](https://img.shields.io/website?up_message=AVAILABLE&down_message=DOWN&url=https%3A%2F%2Fclickhouse.com%2Fdocs&style=for-the-badge)](https://clickhouse.com)
 [![CC BY-NC-SA 4.0 License](https://img.shields.io/badge/license-CC-blueviolet?style=for-the-badge)](http://creativecommons.org/licenses/by-nc-sa/4.0/)
 ![Checks](https://img.shields.io/github/actions/workflow/status/clickhouse/clickhouse-docs/debug.yml?style=for-the-badge&label=Checks)
 
@@ -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/chdb/guides/index.md

@@ -13,12 +13,5 @@ from YAML frontmatter fields title, slug, description. If you've found an error
 in the table of contents, please edit the frontmatter of the files directly.
 -->
 
-| Page | Description |
-|-----|-----|
-| [How to query Parquet files](/chdb/guides/querying-parquet) | Learn how to query Parquet files with chDB. |
-| [How to query data in an S3 bucket](/chdb/guides/querying-s3) | Learn how to query data in an S3 bucket with chDB. |
-| [Using a clickhouse-local database](/chdb/guides/clickhouse-local) | Learn how to use a clickhouse-local database with chDB |
-| [How to query Pandas DataFrames with chDB](/chdb/guides/pandas) | Learn how to query Pandas DataFrames with chDB |
-| [JupySQL and chDB](/chdb/guides/jupysql) | How to install chDB for Bun |
-| [How to query a remote ClickHouse server](/chdb/guides/query-remote-clickhouse) | In this guide, we'll learn how to query a remote ClickHouse server from chDB. |
-| [How to query Apache Arrow with chDB](/chdb/guides/apache-arrow) | In this guide, we'll learn how to query Apache Arrow tables with chDB |
+<!--AUTOGENERATED_START-->
+<!--AUTOGENERATED_END-->

docs/cloud/changelogs/fast-release-24-2.md renamed to docs/cloud/changelogs/24_02.md

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

docs/cloud/changelogs/changelog-24-5.md renamed to docs/cloud/changelogs/24_05.md

@@ -3,7 +3,8 @@ slug: /changelogs/24.5
 title: 'v24.5 Changelog for Cloud'
 description: 'Fast release changelog for v24.5'
 keywords: ['changelog', 'cloud']
-sidebar_label: 'v24.5'
+sidebar_label: '24.5'
+sidebar_position: 7
 ---
 
 # v24.5 Changelog for Cloud

docs/cloud/changelogs/changelog-24-6.md renamed to docs/cloud/changelogs/24_06.md

@@ -3,7 +3,8 @@ slug: /changelogs/24.6
 title: 'v24.6 Changelog for Cloud'
 description: 'Fast release changelog for v24.6'
 keywords: ['changelog', 'cloud']
-sidebar_label: 'v24.6'
+sidebar_label: '24.6'
+sidebar_position: 6
 ---
 
 # v24.6 Changelog for Cloud

docs/cloud/changelogs/changelog-24-8.md renamed to docs/cloud/changelogs/24_08.md

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

docs/cloud/changelogs/changelog-24-10.md renamed to docs/cloud/changelogs/24_10.md

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

docs/cloud/changelogs/changelog-24-12.md renamed to docs/cloud/changelogs/24_12.md

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