fix links

Blargian · Blargian · commit 9db7b9900777 · 2025-06-26T15:49:18.000+02:00
diff --git a/docs/deployment-modes.md b/docs/deployment-modes.md
@@ -45,7 +45,7 @@ This deployment mode is the go-to choice for production environments where relia
 
 <Image img={chCloud} alt="ClickHouse Cloud" size="sm"/>
 
-A key advantage of ClickHouse Cloud is its integrated tooling. [ClickPipes](/cloud/get-started/cloud-quick-start#clickpipes) provides a robust data ingestion framework, allowing you to easily connect and stream data from various sources without managing complex ETL pipelines. The platform also offers a dedicated [querying API](/cloud/get-started/query-endpoints), making it significantly easier to build applications.
+A key advantage of ClickHouse Cloud is its integrated tooling. [ClickPipes](/getting-started/quick-start/cloud/#clickpipes) provides a robust data ingestion framework, allowing you to easily connect and stream data from various sources without managing complex ETL pipelines. The platform also offers a dedicated [querying API](/cloud/get-started/query-endpoints), making it significantly easier to build applications.
 
 The SQL Console in ClickHouse Cloud includes a powerful [dashboarding](/cloud/manage/dashboards) feature that lets you transform your queries into interactive visualizations. You can create and share dashboards built from your saved queries, with the ability to add interactive elements through query parameters. These dashboards can be made dynamic using global filters, allowing users to explore data through customizable views – though it's important to note that users will need at least read access to the underlying saved queries to view the visualizations.
 
diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md
@@ -12,7 +12,7 @@ title: 'Tutorials and Example Datasets'
 
 We have a lot of resources for helping you get started and learn how ClickHouse works:
 
-- If you need to get ClickHouse up and running, check out our [Quick Start](../quick-start.mdx)
+- If you need to get ClickHouse up and running, check out our [Quick Start](/get-started/quick-start)
 - The [ClickHouse Tutorial](../tutorial.md) analyzes a dataset of New York City taxi rides
 
 In addition, the sample datasets provide a great experience on working with ClickHouse,
diff --git a/docs/getting-started/install/_snippets/_quick_install.md b/docs/getting-started/install/_snippets/_quick_install.md
@@ -71,7 +71,7 @@ template](https://github.com/ClickHouse/ClickHouse/blob/master/programs/server/c
 You are now ready to start sending SQL commands to ClickHouse!
 
 :::tip
-The [Quick Start](/quick-start.mdx) walks through the steps for creating tables and inserting data.
+The [Quick Start](/get-started/quick-start) walks through the steps for creating tables and inserting data.
 :::
 
 </VerticalStepper>
diff --git a/docs/guides/best-practices/sparse-primary-indexes.md b/docs/guides/best-practices/sparse-primary-indexes.md
@@ -43,7 +43,7 @@ In this guide we are going to do a deep dive into ClickHouse indexing. We will i
 - [what some of the best practices are for indexing in ClickHouse](#using-multiple-primary-indexes)
 
 You can optionally execute all ClickHouse SQL statements and queries given in this guide by yourself on your own machine.
-For installation of ClickHouse and getting started instructions, see the [Quick Start](/quick-start.mdx).
+For installation of ClickHouse and getting started instructions, see the [Quick Start](/get-started/quick-start).
 
 :::note
 This guide is focusing on ClickHouse sparse primary indexes.
diff --git a/docs/guides/sre/keeper/index.md b/docs/guides/sre/keeper/index.md
@@ -480,7 +480,7 @@ If you have ClickHouse installed, you can use the binary directly:
 clickhouse keeper-converter ...
 ```
 
-Otherwise, you can [download the binary](/getting-started/quick-start#download-the-binary) and run the tool as described above without installing ClickHouse.
+Otherwise, you can [download the binary](/get-started/quick-start#download-the-binary) and run the tool as described above without installing ClickHouse.
 :::
 
 
diff --git a/docs/integrations/sql-clients/jupysql.md b/docs/integrations/sql-clients/jupysql.md
@@ -41,7 +41,7 @@ from sklearn_evaluation import plot
 
 **You'd need to make sure your Clickhouse is up and reachable for the next stages. You can use either the local or the cloud version.**
 
-**Note:** you will need to adjust the connection string according to the instance type you're trying to connect to (url, user, password). In the example below we've used a local instance. To learn more about it, check out [this guide](/getting-started/quick-start).
+**Note:** you will need to adjust the connection string according to the instance type you're trying to connect to (url, user, password). In the example below we've used a local instance. To learn more about it, check out [this guide](/get-started/quick-start).
 
 
 ```python
diff --git a/docs/introduction-index.md b/docs/introduction-index.md
@@ -10,7 +10,7 @@ Welcome to ClickHouse! Check out the pages below to learn how to get up and runn
 | Page                                           | Description                                                        |
 |------------------------------------------------|--------------------------------------------------------------------|
 | [What is ClickHouse?](about-us/intro.mdx)      | Learn more about what ClickHouse is.                               |
-| [Quick Start](quick-start.mdx)                 | Quick start guide to get you up and running in no time.            |           
+| [Quick Start](/get-started/quick-start)        | Quick start guide to get you up and running in no time.            |           
 | [Advanced Tutorial](tutorial.md)               | Comfortable with the basics? Let's do something more interesting.  |
 | [Install](getting-started/install/install.mdx) | Learn about the various ways you can install ClickHouse.           |
 | [Deployment modes](deployment-modes.md)        | This guide explores the four main ways to deploy and use ClickHouse.| 
diff --git a/docs/tutorial.md b/docs/tutorial.md
@@ -16,7 +16,7 @@ Learn how to ingest and query data in ClickHouse using a New York City taxi exam
 
 ### Prerequisites {#prerequisites}
 
-You need access to a running ClickHouse service to complete this tutorial. For instructions, see the [Quick Start](./quick-start.mdx) guide.
+You need access to a running ClickHouse service to complete this tutorial. For instructions, see the [Quick Start](/get-started/quick-start) guide.
 
 <VerticalStepper>
 
diff --git a/docs/use-cases/observability/clickstack/getting-started.md b/docs/use-cases/observability/clickstack/getting-started.md
@@ -96,7 +96,7 @@ Users can deploy ClickStack against ClickHouse Cloud, benefiting from a fully ma
 
 ### Create a ClickHouse Cloud service {#create-a-service}
 
-Follow the [getting started guide for ClickHouse Cloud](/cloud/get-started/cloud-quick-start#1-create-a-clickhouse-service) to create a service.
+Follow the [getting started guide for ClickHouse Cloud](/getting-started/quick-start/cloud#1-create-a-clickhouse-service) to create a service.
 
 ### Copy connection details {#copy-cloud-connection-details}
 
diff --git a/docs/use-cases/observability/clickstack/production.md b/docs/use-cases/observability/clickstack/production.md
@@ -139,7 +139,7 @@ The following represents a simple deployment of ClickStack using ClickHouse Clou
 
 ### Create a service {#create-a-service}
 
-Follow the [getting started guide for ClickHouse Cloud](/cloud/get-started/cloud-quick-start#1-create-a-clickhouse-service) to create a service.
+Follow the [getting started guide for ClickHouse Cloud](/getting-started/quick-start/cloud/#1-create-a-clickhouse-service) to create a service.
 
 ### Copy connection details {#copy-connection-details}
 
diff --git a/package.json b/package.json
@@ -7,7 +7,7 @@
     "autogen_needed_files": "src/Core/FormatFactorySettings.h src/Core/Settings.cpp CHANGELOG.md docs/en/operations/server-configuration-parameters/_server_settings_outside_source.md"
   },
   "scripts": {
-    "build": "yarn copy-clickhouse-repo-docs && yarn check-markdown && yarn generate-changelog && yarn autogenerate-settings && yarn autogenerate-table-of-contents && yarn build-swagger && yarn build-docs",
+    "build": "yarn copy-clickhouse-repo-docs && yarn check-markdown && yarn generate-changelog && yarn autogenerate-settings && yarn autogenerate-table-of-contents && yarn build-swagger && scripts/sed_links.sh && yarn build-docs",
     "clear": "docusaurus clear && bash ./placeholderReset.sh",
     "deploy": "docusaurus deploy",
     "docusaurus": "docusaurus",
diff --git a/scripts/sed_links.sh b/scripts/sed_links.sh
@@ -0,0 +1,10 @@
+#!/bin/bash
+
+# Sometimes we need to change links which are reporting as broken
+# but they are from the ClickHouse/ClickHouse repo. In this case
+# it's useful to sed the link so that the build can pass and then
+# change it over on ClickHouse/ClickHouse once the PR has been merged
+# on ClickHouse/clickhouse-docs
+
+sed -i '' 's|(../../quick-start\.mdx)|(/get-started/quick-start)|g' docs/operations/utilities/clickhouse-local.md
+sed -i '' 's|(/get-started/quick-start#download-the-binary)|(/getting-started/quick-start/oss/#download-the-binary)|g' docs/operations/utilities/clickhouse-local.md
