Merge branch 'main' into autogenerate_mergetree_settings

Author: Blargian

README.md

@@ -134,7 +134,12 @@ Check out the GitHub docs for a refresher on [how to create a pull request](http
 
 ### Style guidelines
 
-For style guidelines, see ["Style guide"](/contribute/style-guide.md).
+For documentation style guidelines, see ["Style guide"](/contribute/style-guide.md).
+
+### Generating documentation from source code
+
+For an overview of how reference documentation such as settings, system tables
+and functions are generated from the source code, see ["Generating documentation from source code"](/contribute/autogenerated-documentation-from-source.md)
 
 ### Tests and CI/CD {#tests-and-cicd}
 

contribute/autogenerated-documentation-from-source.md

@@ -0,0 +1,48 @@
+# Generating documentation from source code
+
+A [script in our docs repo](https://github.com/ClickHouse/clickhouse-docs/blob/main/scripts/settings/autogenerate-settings.sh) 
+extracts setting names, descriptions, default values, etc. from ClickHouse's source code.
+
+## Session settings
+
+Documentation for session settings are extracted from [`src/Core/Settings.cpp`](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
+
+## Format settings
+
+Documentation for session settings are extracted from [`src/Core/FormatFactorySettings.h`](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h).
+
+## Server settings
+
+Documentation for session settings are extracted from [`src/Core/ServerSettings.cpp`](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/ServerSettings.cpp).
+
+Note that this file contains only a fraction of all server settings. 
+The reason is that server settings can be nested and `system.server_settings` 
+(which is built from `src/Core/ServerSettings.cpp`) and cannot represent nested
+settings.
+
+Example:
+
+```yaml
+<query_cache>
+    <max_size_in_bytes>1073741824</max_size_in_bytes>
+    <max_entries>1024</max_entries>
+    <max_entry_size_in_bytes>1048576</max_entry_size_in_bytes>
+    <max_entry_size_in_rows>30000000</max_entry_size_in_rows>
+</query_cache>
+```
+As a result of the above, you will find the server settings which are not found 
+in `system.server_settings` documented in file `_server_settings_outside_source.md`
+
+The auto-generation script reads these in, combines them with the ones from 
+`system.settings` and appends the formatted settings to `settings.md`.
+
+**As such, if you need to make a change to the settings you see on the 
+[server settings](clickhouse.com/docs/operations/server-configuration-parameters/) 
+page, you will need to check if the setting is in `system.server_settings`. 
+If it is, then please edit the setting description in the source code documentation
+in [`ServerSettings.cpp`](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/ServerSettings.cpp) 
+or else edit `_server_settings_outside_source.md`.**
+
+## System tables
+
+## Functions

docs/about-us/adopters.md

@@ -79,6 +79,7 @@ The following list of companies using ClickHouse and their success stories is as
 | [Bloxy](https://bloxy.info) | Blockchain | Analytics | — | — | [Slides in Russian, August 2018](https://github.com/ClickHouse/clickhouse-presentations/blob/master/meetup17/4_bloxy.pptx) |
 | [Bonree](https://www.bonree.com/) | Software & Technology | Performance Monitoring & Observability | — | — | ClickHouse Meetup in Hangzhou, May 2024 |
 | [Bonside](https://www.bonside.com/) | FinTech | - | — | — | [Hacker News, July 2023](https://news.ycombinator.com/item?id=36619722) |
+| [BoundaryML](https://www.boundaryml.com/)| Software Development | AI Platform| — | — | [Meetup, March 2025](https://youtu.be/DV-zkQUvuPc) |
 | [Botify](https://www.botify.com/) | SaaS | SEO | — | — | [Blog Article, September 2022](https://tech.marksblogg.com/billion-taxi-rides-doublecloud-clickhouse.html) |
 | [Braintrust](https://www.usebraintrust.com/) | Software & Technology | Real-time Analytics | — | — | [Written Blog from Meetup Video, July 2024](https://clickhouse.com/blog/building-better-ai-products-faster-how-braintrust-uses-clickhouse-for-real-time-data-analysis) |
 | [Buildkite](https://buildkite.com/)| Software & Technology | Real-time analytics | — | — | [Wellington meetup, February 2025](https://clickhouse.com/videos/wellington-meetup-buildkite-clickhouse-test-analytics) |
@@ -268,6 +269,7 @@ The following list of companies using ClickHouse and their success stories is as
 | [Kyligence](https://kyligence.io/) | Managed Service | Main Product | — | — | [Website](https://kyligence.io/all-inclusive-olap/) |
 | [LANCOM Systems](https://www.lancom-systems.com/) | Network Solutions | Traffic analysis | - | - | [ClickHouse Operator for Kubernetes](https://www.lancom-systems.com/), [Hacker News post](https://news.ycombinator.com/item?id=29413660) |
 | [Langchain](https://www.langchain.com/) | Software & Technology | LLM Monitoring | - | - | [Blog, Apr 2024](https://clickhouse.com/blog/langchain-why-we-choose-clickhouse-to-power-langchain) |
+| [LangFuse](https://langfuse.com/) | Software & Technology | LLM Monitoring | - | - | [Meetup, March 2025](https://youtu.be/AnghkoucpN0) |
 | [Langtrace AI](https://www.langtrace.ai/) | Software & Technology | LLM Monitoring | - | - | [Twitter, May 2024](https://x.com/karthikkalyan90/status/1790483625743716703) |
 | [Lago](https://www.getlago.com/) | Billing automation | - | — | — | [GitHub Wiki post](https://github.com/getlago/lago/wiki/How-ClickHouse-saved-our-events-engine-problem) |
 | [Lagon](https://lagon.app/) | Software Development | Serverless Functions | — | — | [Twitter, 2023](https://twitter.com/tomlienard/status/1702759256909394010) |
@@ -325,7 +327,7 @@ The following list of companies using ClickHouse and their success stories is as
 | [Neocom](https://www.neocom.ai/) | Software & Technology | Sales Platform | — | — | [Hacker News, September 2023](https://news.ycombinator.com/item?id=37359122) |
 | [NeonDB](https://neon.tech/) | Cloud | Postgres management | - | - | [Blog, 2024](https://double.cloud/resources/case-studies/neon-increases-data-granularity-with-managed-clickhouse/) |
 | [NetMeta](https://github.com/monogon-dev/NetMeta/blob/main/README.md) | Observability | Main Product | — | — | [Twitter, December 2022](https://twitter.com/leolukde/status/1605643470239977475) |
-| [Netflix](https://www.netflix.com/) | Software & Technology | Video Streaming | — | — | [Twitter, June 2023](https://twitter.com/clickhousedb/status/1673803621220360193) |
+| [Netflix](https://www.netflix.com/) | Software & Technology | Video Streaming | — | — | [Meetup, March 2025](https://youtu.be/64TFG_Qt5r4) |
 | [Netskope](https://www.netskope.com/) | Network Security | — | — | — | [Job advertisement, March 2021](https://www.mendeley.com/careers/job/senior-software-developer-backend-developer-1346348) |
 | [Nexpath Networks](https://www.nexpath.net/) | Software & Technology | Network Analysis | — | — | [Slides, September 2021](https://opensips.org/events/Summit-2021Distributed/assets/presentations/2021-jon-abrams-big-telco-data-with-clickhouse.pdf) [Video, September 2021](https://www.youtube.com/watch?v=kyu_wDcO0S4&t=3840s) |
 | [NineData](https://www.ninedata.cloud/) | Software & Technology | DMaaS | — | — | ClickHouse Meetup in Hangzhou, May 2024 |

docs/cloud/bestpractices/index.md

@@ -1,6 +1,6 @@
 ---
 slug: /cloud/bestpractices
-keywords: ['Cloud', 'Best Practices', 'Bulk Inserts', 'Asynchronous Inserts', 'Avoid Mutations', 'Avoid Nullable Columns', 'Avoid Optimize Final', 'Low Cardinality Partitioning Key']
+keywords: ['Cloud', 'Best Practices', 'Bulk Inserts', 'Asynchronous Inserts', 'Avoid Mutations', 'Avoid Nullable Columns', 'Avoid Optimize Final', 'Low Cardinality Partitioning Key', 'Multi Tenancy']
 title: 'Overview'
 hide_title: true
 description: 'Landing page for Best Practices section in ClickHouse'
@@ -18,4 +18,5 @@ This section provides six best practices you will want to follow to get the most
 | [Avoid Nullable Columns](/cloud/bestpractices/avoid-nullable-columns)                            | Learn why you should ideally avoid Nullable columns                        |
 | [Avoid Optimize Final](/cloud/bestpractices/avoid-optimize-final)                              | Learn why you should avoid `OPTIMIZE TABLE ... FINAL`                      |
 | [Choose a Low Cardinality Partitioning Key](/cloud/bestpractices/low-cardinality-partitioning-key)         | Learn how to choose a low cardinality partitioning key.                    |
-| [Usage Limits](/cloud/bestpractices/usage-limits)| Explore the limits of ClickHouse.                                          |
+| [Usage Limits](/cloud/bestpractices/usage-limits)| Explore the limits of ClickHouse.                                          |
+| [Multi tenancy](/cloud/bestpractices/multi-tenancy)| Learn about different strategies to implement multi-tenancy.                                          |