Merge pull request #3179 from Blargian/landing_pages_reference

Add landing pages for `Getting Started` page
ClickHouse · Feb 1, 2025 · 7279ef7 · 7279ef7
2 parents 6c3c781 + 6973a74
commit 7279ef7
Show file tree

Hide file tree

Showing 16 changed files with 258 additions and 109 deletions.
diff --git a/docs/en/concepts/index.md b/docs/en/concepts/index.md
@@ -0,0 +1,17 @@
+---
+title: Concepts
+slug: /en/concepts
+description: Landing page for concepts
+pagination_next: null
+pagination_prev: null
+---
+
+In this section of the docs we'll dive into the concepts around what makes ClickHouse so fast and efficient. 
+
+| Page                                                             | Description                                                                           |
+|------------------------------------------------------------------|---------------------------------------------------------------------------------------|
+| [Why is ClickHouse so Fast?](./why-clickhouse-is-so-fast.md)     | Learn what makes ClickHouse so fast.                                                  
+| [What is OLAP?](./olap.md)                                       | Learn what Online Analytical Processing is.                                           
+| [Why is ClickHouse unique?](../about-us/distinctive-features.md) | Learn what makes ClickHouse unique.                                                   
+| [Glossary](./glossary.md)                                        | This page contains a glossary of terms you'll commonly encounter throughout the docs. 
+| [FAQ](../faq/index.md)                                           | A compilation of the most frequently asked questions we get about ClickHouse.         
diff --git a/docs/en/faq/index.md b/docs/en/faq/index.md
@@ -0,0 +1,15 @@
+---
+slug: /en/concepts/faq
+title: FAQ
+description: Landing page for FAQ
+pagination_prev: null
+pagination_next: null
+---
+
+| Page                                                          | Description                                                                            |
+|---------------------------------------------------------------|----------------------------------------------------------------------------------------|
+| [General Questions about ClickHouse](general/index.md)        | General questions we get about ClickHouse.                                             |
+| [Why not use something like MapReduce?](general/mapreduce.md) | Explainer on why MapReduce implementations are not appropriate for the OLAP scenario.  |
+| [What does "не тормозит" mean](general/ne-tormozit.md)        | Explainer on what "не тормозит" means, which you may have seen on ClickHouse t-shirts. |
+| [What is OLAP](general/olap.md)                               | Explainer on what Online Analytical Processing is.                                     |
+| [Who is using ClickHouse](general/who-is-using-clickhouse.md) | Learn about who is using ClickHouse.                                                   |
diff --git a/docs/en/guides/inserting-data.md b/docs/en/guides/inserting-data.md
@@ -1,7 +1,8 @@
 ---
-title: Inserting Data
+title: Inserting ClickHouse data
 description: How to insert data into ClickHouse
 keywords: [insert, insert data, insert into table]
+sidebar_label: Inserting ClickHouse data
 ---
 
 ## Basic Example

diff --git a/docs/en/guides/writing-queries.md b/docs/en/guides/writing-queries.md
@@ -1,10 +1,9 @@
 ---
 sidebar_position: 3
-sidebar_label: SELECT Queries
+sidebar_label: Selecting data
+title: Selecting ClickHouse Data
 ---
 
-# SELECT Queries in ClickHouse
-
 ClickHouse is a SQL database, and you query your data by writing the same type of `SELECT` queries you are already familiar with. For example:
 
 ```sql

diff --git a/docs/en/introduction-index.md b/docs/en/introduction-index.md
@@ -0,0 +1,15 @@
+---
+slug: /en/introduction-clickhouse
+title: Introduction
+description: Landing page for Introduction
+pagination_next: null
+---
+
+Welcome to ClickHouse! Check out the pages below to learn how to get up and running with ClickHouse - the fastest and most resource efficient real-time data warehouse and open-source database.
+
+| 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.            |           
+| [Advanced Tutorial](tutorial.md)          | Comfortable with the basics? Let's do something more interesting.  |
+| [Install](getting-started/install.md)     | Learn about the various ways you can install ClickHouse.           |
diff --git a/docs/en/managing-data/core-concepts/index.md b/docs/en/managing-data/core-concepts/index.md
@@ -1,5 +1,5 @@
 ---
-slug: /en/concepts
+slug: /en/managing-data/core-concepts
 title: Core Concepts
 description: Learn Core Concepts of how ClickHouse works
 keywords: [concepts, part, partition, primary index]

diff --git a/docs/en/migrations/bigquery/equivalent-concepts.md b/docs/en/migrations/bigquery/equivalent-concepts.md
@@ -1,6 +1,6 @@
 ---
 title: BigQuery vs ClickHouse Cloud
-slug: /en/migrations/bigquery
+slug: /en/migrations/bigquery/biquery-vs-clickhouse-cloud
 description: How BigQuery differs from ClickHouse Cloud
 keywords: [migrate, migration, migrating, data, etl, elt, BigQuery]
 ---

diff --git a/docs/en/migrations/bigquery/index.md b/docs/en/migrations/bigquery/index.md
@@ -0,0 +1,15 @@
+---
+slug: /en/migrations/bigquery
+title: BigQuery
+pagination_prev: null
+pagination_next: null
+---
+
+In this section of the docs, learn more about the similarities and differences between BigQuery and ClickHouse Cloud, as well as why you might want to migrate and how to do so.
+
+| Page                                                                              | Description                                                                                                                                            |
+|-----------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [BigQuery vs ClickHouse Cloud](./equivalent-concepts.md)                          | The way resources are organized in ClickHouse Cloud is similar to BigQuery's resource hierarchy. We describe the specific differences in this article. | 
+| [Migrating from BigQuery to ClickHouse Cloud](./migrating-to-clickhouse-cloud.md) | Learn about why you might want to migrate from BigQuery to ClickHouse Cloud.                                                                           |
+| [Loading Data](./loading-data.md)                                                 | A guide showing you how to migrate data from BigQuery to ClickHouse.                                                                                   |
+
diff --git a/docs/en/migrations/index.md b/docs/en/migrations/index.md
@@ -0,0 +1,16 @@
+---
+slug: en/migrations
+title: Migrations
+pagination_prev: null
+pagination_next: null
+---
+
+| Page                                                              | Description                    |
+|-------------------------------------------------------------------|--------------------------------|
+| [BigQuery](bigquery/index.md)                                     | Migration guide for BigQuery   |
+| [Snowflake](./snowflake.md)                                       | Migration guide for Snowflake  |
+| [PostgreSQL](postgres/index.md)                                   | Migration guide for PostgreSQL |
+| [MySQL](../integrations/data-ingestion/dbms/mysql/index.md)       | Migration guide for MySQL      |
+| [Redshift](../integrations/data-ingestion/redshift/index.md)      | Migration guide for Redshift   |
+| [DynamoDB](../integrations/data-ingestion/dbms/dynamodb/index.md) | Migration guide for DynamoDB   |
+| [Rockset](../integrations/migration/rockset.md)                   | Migration guide for Rockset    |
diff --git a/docs/en/migrations/postgres/index.md b/docs/en/migrations/postgres/index.md
@@ -0,0 +1,18 @@
+---
+slug: en/migrations/postgresql
+pagination_prev: null
+pagination_next: null
+title: PostgreSQL
+---
+
+| Page                                                                                                                 | Description                                                                                                                                                             |
+|----------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [Introduction](./overview.md)                                                                                        | Introduction page for this section                                                                                                                                      |
+| [Connecting to PostgreSQL](../../integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md)            | This page covers the following options for integrating PostgreSQL with ClickHouse: ClickPipes, PeerDB, PostgreSQL table engine, MaterializedPostgreSQL database engine. |
+| [Comparing PostgreSQL and ClickHouse](../../integrations/data-ingestion/dbms/postgresql/postgres-vs-clickhouse.md)   | Explores Postgres vs ClickHouse - Equivalent and different concepts.                                                                                                    |
+| [Loading data from PostgreSQL to ClickHouse](./dataset.md)                                                           | Part 1 of a guide on migrating from PostgreSQL to ClickHouse.                                                                                                           |
+| [Designing Schemas](./designing-schemas.md)                                                                          | Part 2 of a guide on migrating from PostgreSQL to ClickHouse.                                                                                                           |
+| [Data modeling techniques](./data-modeling-techniques.md)                                                            | Part 3 of a guide on migrating from PostgreSQL to ClickHouse.                                                                                                           |
+| [Rewrite PostgreSQL Queries](../../integrations/data-ingestion/dbms/postgresql/rewriting-postgres-queries.md)        | Part 4 of a guide on migrating from PostgreSQL to ClickHouse.                                                                                                           |
+| [How to insert data from PostgreSQL](../../integrations/data-ingestion/dbms/postgresql/inserting-data.md)            | Learn how to bulk load data from PostgreSQL to ClickHouse.                                                                                                              |
+| [Data Type Mappings for PostgreSQL](../../integrations/data-ingestion/dbms/postgresql/data-type-mappings.md)         | Table showing the equivalent ClickHouse data types for Postgres.                                                                                                        |
diff --git a/docs/en/starter-guides/index.md b/docs/en/starter-guides/index.md
@@ -0,0 +1,16 @@
+---
+slug: /en/starter-guides
+title: Starter Guides
+description: Landing page for starter guides
+pagination_prev: null
+pagination_next: null
+---
+
+In this section of the docs you'll find starter guides for common SQL queries: `CREATE`, `INSERT`, `SELECT`, and mutations `UPDATE` and `DELETE`.
+
+| Page                                                       | Description                                                            |
+|------------------------------------------------------------|------------------------------------------------------------------------|
+| [Create Tables](../guides/creating-tables.md)              | Starter guide on how to create a table.                                |
+| [Insert Data](../guides/inserting-data.md)                 | Starter guide on how to insert data into a table.                      |
+| [Select Data](../guides/writing-queries.md)                | Starter guide on how to select data from a table.                      |
+| [Update and Delete Data](../guides/developer/mutations.md) | Starter guide on mutations - updating and deleting data in ClickHouse. |
diff --git a/docs/en/use-cases/index.md b/docs/en/use-cases/index.md
@@ -0,0 +1,12 @@
+---
+slug: /en/use-cases
+title: Use Case Guides
+pagination_prev: null
+pagination_next: null
+---
+
+In this section of the docs you can find our use case guides.
+
+| Page                                    | Description                                                         |
+|-----------------------------------------|---------------------------------------------------------------------|
+| [Observability](observability/index.md) | Use case guide on how to setup and use ClickHouse for Observability |