restructure backups page

Blargian · Blargian · commit bd77b90bff24 · 2025-01-24T18:32:04.000+01:00
diff --git a/docs/en/cloud/manage/backups/configurable-backups.md b/docs/en/cloud/manage/backups/configurable-backups.md
@@ -0,0 +1,44 @@
+---
+sidebar_label: Configurable Backups
+slug: /en/cloud/manage/backups/configurable-backups
+description: Configurable Backups
+title: Configurable Backups
+keywords: [backups, cloud backups, restore]
+---
+
+import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge';
+import ScalePlanFeatureBadge from '@theme/badges/ScalePlanFeatureBadge';
+
+<ScalePlanFeatureBadge feature="Configurable Backups" linking_verb_are="True"/>
+
+ClickHouse Cloud allows you to configure the schedule for your backups for **Scale** and **Enterprise** tier services. Backups can be configured along the following dimensions based on your business needs.
+
+- **Retention**: The duration of days, for which each backup will be retained. Retention can be specified as low as 1 day, and as high as 30 days with several values to pick in between.
+- **Frequency**: The frequency allows you to specify the time duration between subsequent backups. For instance, a frequency of "every 12 hours" means that backups will be spaced 12 hours apart. Frequency can range from "every 6 hours" to "every 48 hours" in the following hourly increments: `6`, `8`, `12`, `16`, `20`, `24`, `36`, `48`.
+- **Start Time**: The start time for when you want to schedule backups each day. Specifying a start time implies that the backup "Frequency" will default to once every 24 hours.  Clickhouse Cloud will start the backup within an hour of the specified start time.
+
+:::note
+The custom schedule will override the default backup policy in ClickHouse Cloud for your given service.
+:::
+
+To configure the backup schedule for a service, go to the **Settings** tab in the console and click on **Change backup configuration**.
+
+<div class="eighty-percent">
+![Configure backup settings](../images/backup-settings.png)
+</div>
+<br/>
+
+This opens a tab to the right where you can choose values for retention, frequency, and start time. You will need to save the chosen settings for them to take effect.
+
+<div class="eighty-percent">
+![Select backup retention and frequency](../images/backup-configuration-form.png)
+</div>
+<br/>
+
+:::note
+Start time and frequency are mutually exclusive. Start time takes precedence.
+:::
+
+:::note
+Changing the backup schedule can cause higher monthly charges for storage as some of the backups might not be covered in the default backups for the service. See ["Understanding backup cost"](./overview.md/#understanding-backup-cost) section below.
+:::
diff --git a/docs/en/cloud/manage/backups/export-backups-to-own-cloud-account.md b/docs/en/cloud/manage/backups/export-backups-to-own-cloud-account.md
@@ -1,6 +1,6 @@
 ---
 sidebar_label: Export Backups to your Own Cloud Account
-slug: /en/cloud/manage/bring-your-own-bucket
+slug: /en/cloud/manage/backups/export-backups-to-own-cloud-account
 title: Export Backups to your Own Cloud Account
 ---
 
@@ -9,12 +9,12 @@ import EnterprisePlanFeatureBadge from '@theme/badges/EnterprisePlanFeatureBadge
 <EnterprisePlanFeatureBadge/>
 
 ClickHouse Cloud supports taking backups to your own cloud service provider (CSP) account (AWS S3, Google Cloud Storage, or Azure Blob Storage).
-For details of how ClickHouse Cloud backups work, including "full" vs. "incremental" backups, see the [backups](./backups.md) docs.
+For details of how ClickHouse Cloud backups work, including "full" vs. "incremental" backups, see the [backups](backups.md) docs.
 
 Here we show examples of how to take full and incremental backups to AWS, GCP, Azure object storage as well as how to restore from the backups.
 
 :::note
-Users should be aware that any usage where backups are being exported to a different region in the same cloud provider, or to another cloud provider (in the same or different region) will incur [data transfer](./network-data-transfer.mdx) charges.
+Users should be aware that any usage where backups are being exported to a different region in the same cloud provider, or to another cloud provider (in the same or different region) will incur [data transfer](../network-data-transfer.mdx) charges.
 :::
 
 ## Requirements
diff --git a/docs/en/cloud/manage/backups/index.md b/docs/en/cloud/manage/backups/index.md
@@ -0,0 +1,11 @@
+---
+slug: /en/cloud/manage/backups
+title: Backups
+description: Table of contents page for backups.
+keywords: [backups, configurable backups, export backups to own cloud]
+---
+
+| Page                      | Description |
+|---------------------------|-------------|
+| [Overview](./overview.md) |             |
+|                           |             |
diff --git a/docs/en/cloud/manage/backups/overview.md b/docs/en/cloud/manage/backups/overview.md
@@ -1,7 +1,8 @@
 ---
-sidebar_label: Backups
-slug: /en/cloud/manage/backups
-description: Managing backups in ClickHouse Cloud
+sidebar_label: Overview
+sidebar_position: 0
+slug: /en/cloud/manage/backups/overview
+title: Overview
 keywords: [backups, cloud backups, restore]
 ---
 
@@ -20,65 +21,29 @@ In the screenshot below, the solid line squares show full backups and the dotted
 
 On Day 1, a full backup is taken to start the backup chain. On Day 2, an incremental backup is taken, and we now have a full and incremental backup available to restore from. By Day 7, we have one full backup and six incremental backups in the chain, with the most recent two incremental backups visible to the user. On Day 8, we take a new full backup, and on Day 9, once we have two backups in the new chain, the previous chain is discarded.
 
-![Backup chain](./images/backup-chain.png)
+![Backup chain](../images/backup-chain.png)
 
 *Example backup scenario in Clickhouse Cloud*
 
 ## Default backup policy
 
-All services will default to one backup, retained for a day with the new Pricing tiers. 
-Users who need additional backups can do so by configuring additional backups under the settings tab of the Cloud Console. 
+All services will default to one backup, retained for a day with the new Pricing tiers.
+Users who need additional backups can do so by configuring additional backups under the settings tab of the Cloud Console.
 No free backups are included in the new pricing.
 
-## Configurable backups
-
-<ScalePlanFeatureBadge feature="Configurable Backups" linking_verb_are="True"/>
-
-ClickHouse Cloud allows you to configure the schedule for your backups for **Scale** and **Enterprise** tier services. Backups can be configured along the following dimensions based on your business needs.
-
-- **Retention**: The duration of days, for which each backup will be retained. Retention can be specified as low as 1 day, and as high as 30 days with several values to pick in between.
-- **Frequency**: The frequency allows you to specify the time duration between subsequent backups. For instance, a frequency of "every 12 hours" means that backups will be spaced 12 hours apart. Frequency can range from "every 6 hours" to "every 48 hours" in the following hourly increments: `6`, `8`, `12`, `16`, `20`, `24`, `36`, `48`.
-- **Start Time**: The start time for when you want to schedule backups each day. Specifying a start time implies that the backup "Frequency" will default to once every 24 hours.  Clickhouse Cloud will start the backup within an hour of the specified start time.
-
-:::note
-The custom schedule will override the default backup policy in ClickHouse Cloud for your given service.
-:::
-
-To configure the backup schedule for a service, go to the **Settings** tab in the console and click on **Change backup configuration**.
-
-<div class="eighty-percent">
-![Configure backup settings](./images/backup-settings.png)
-</div>
-<br/>
-
-This opens a tab to the right where you can choose values for retention, frequency, and start time. You will need to save the chosen settings for them to take effect.
-
-<div class="eighty-percent">
-![Select backup retention and frequency](./images/backup-configuration-form.png)
-</div>
-<br/>
-
-:::note
-Start time and frequency are mutually exclusive. Start time takes precedence. 
-:::
-
-:::note
-Changing the backup schedule can cause higher monthly charges for storage as some of the backups might not be covered in the default backups for the service. See ["Understanding backup cost"](#understanding-backup-cost) section below.
-:::
-
 ## Backup status list
 
 Your service will be backed up based on the set schedule, whether it is the default daily schedule or a custom schedule picked by you. All available backups can be viewed from the **Backups** tab of the service. From here, you can see the status of the backup, the duration, as well as the size of the backup. You can also restore a specific backup using the **Actions** column.
 
-![List of backups statuses](./images/backup-status-list.png)
+![List of backups statuses](../images/backup-status-list.png)
 
 ## Understanding backup cost
 
 ClickHouse Cloud includes two backups for free, but choosing a schedule that requires retaining more data, or causes more frequent backups can cause additional storage charges for backups. If you do not change the default settings, you will not incur any backup cost.
 
 To understand the backup cost, you can view the backup cost per service from the usage screen (as shown below). Once you have backups running for a few days with a customized schedule, you can get an idea of the cost and extrapolate to get the monthly cost for backups.
 
-![Backup usage chart](./images/backup-usage.png)
+![Backup usage chart](../images/backup-usage.png)
 
 Estimating the total cost for your backups requires you to set a schedule. We are also working on updating our [pricing calculator](https://clickhouse.com/pricing), so you can get a monthly cost estimate before setting a schedule. You will need to provide the following inputs in order to estimate the cost:
 - Size of the full and incremental backups
@@ -97,14 +62,14 @@ Backups are restored to a new ClickHouse Cloud service, not to the existing serv
 
 After clicking on the **Restore** backup icon, you can specify the service name of the new service that will be created, and then restore this backup:
 
-![Restoring a backup](./images/backup-restore.png)
+![Restoring a backup](../images/backup-restore.png)
 
 The new service will show in the services list as `Provisioning` until it is ready:
 
-<img src={require('./images/backup-service-provisioning.png').default}    
-  class="image"
-  alt="Provisioning service in progress"
-  style={{width: '80%'}} />
+<img src={require('../images/backup-service-provisioning.png').default}    
+class="image"
+alt="Provisioning service in progress"
+style={{width: '80%'}} />
 
 ## Working with your restored service
 
@@ -189,12 +154,12 @@ After you have successfully inserted the data into your original service, make s
 
 <CloudNotSupportedBadge/>
 
-The `UNDROP` command is not supported in ClickHouse Cloud. If you accidentally `DROP` a table, the best course of action is to restore your last backup and recreate the table from the backup. 
+The `UNDROP` command is not supported in ClickHouse Cloud. If you accidentally `DROP` a table, the best course of action is to restore your last backup and recreate the table from the backup.
 
 To prevent users from accidentally dropping tables, you can use [`GRANT` statements](/docs/en/sql-reference/statements/grant) to revoke permissions for the [`DROP TABLE` command](/docs/en/sql-reference/statements/drop#drop-table) for a specific user or role.
 
 :::note
-To prevent accidental deletion of data, please note that by default it is not possible to drop tables >`1TB` in size in ClickHouse Cloud. 
+To prevent accidental deletion of data, please note that by default it is not possible to drop tables >`1TB` in size in ClickHouse Cloud.
 Should you wish to drop tables greater than this threshold you can use setting `max_table_size_to_drop` to do so:
 
 ```sql
@@ -205,4 +170,4 @@ SYNC SETTINGS max_table_size_to_drop=2097152 -- increases the limit to 2TB
 
 ## Export backups to your own cloud account
 
-For users wanting to export backups to their own cloud account, see [here](/docs/en/cloud/manage/bring-your-own-bucket).
+For users wanting to export backups to their own cloud account, see [here](./configurable-backups.md).
diff --git a/docs/en/cloud/manage/billing.md b/docs/en/cloud/manage/billing.md
@@ -24,7 +24,7 @@ Storage costs are the same across tiers and vary by region and cloud service pro
 
 Storage and backups are counted towards storage costs and billed separately. 
 All services will default to one backup, retained for a day. 
-Users who need additional backups can do so by configuring additional [backups](./backups.md) under the settings tab of the Cloud Console.
+Users who need additional backups can do so by configuring additional [backups](backups/backups.md) under the settings tab of the Cloud Console.
 
 ### How do I estimate compression?
 
diff --git a/sidebars.js b/sidebars.js
@@ -216,10 +216,12 @@ const sidebars = {
           label: "Backups",
           collapsed: true,
           collapsible: true,
-          link: {type: "doc", id: "en/cloud/manage/backups"},
           items: [
-            "en/cloud/manage/bring-your-own-bucket",
-          ],
+            {
+              type: "autogenerated",
+              dirName: "en/cloud/manage/backups",
+            }
+            ]
         },
         {
           type: "category",
diff --git a/src/css/custom.scss b/src/css/custom.scss
@@ -155,6 +155,7 @@ body {
      * or in the columns on the doc homepage */
     filter: none;
     background-color: transparent;
+    box-shadow: none;
   }
 }
 

Original file line number	Diff line number	Diff line change
`@@ -155,6 +155,7 @@ body {`
`155`	`155`	`* or in the columns on the doc homepage */`
`156`	`156`	`filter: none;`
`157`	`157`	`background-color: transparent;`
	`158`	`+ box-shadow: none;`
`158`	`159`	`}`
`159`	`160`	`}`
`160`	`161`