Hosting Docs Update

.cloudcannon/routing.json

@@ -353,22 +353,22 @@
     },
     {
       "from": "/documentation/host/dns/cloudcannon-dns/",
-      "to": "/documentation/articles/using-cloudcannon-dns-to-configure-your-custom-domain/",
+      "to": "/documentation/articles/configure-cloudcannon-dns/",
       "status": 301
     },
     {
       "from": "/documentation/host/dns/external-dns/",
-      "to": "/documentation/articles/using-external-dns-to-configure-your-custom-domain/",
+      "to": "/documentation/articles/configure-external-dns/",
       "status": 301
     },
     {
       "from": "/documentation/host/dns/",
-      "to": "/documentation/articles/using-cloudcannon-dns-to-configure-your-custom-domain/",
+      "to": "/documentation/articles/configure-cloudcannon-dns/",
       "status": 301
     },
     {
       "from": "/documentation/host/domains/",
-      "to": "/documentation/articles/hosting-your-site-on-a-custom-domain/",
+      "to": "/documentation/articles/add-a-custom-domain/",
       "status": 301
     },
     {
@@ -1450,6 +1450,36 @@
       "from": "/documentation/articles/activating-flags/",
       "to": "/documentation/articles/what-are-flags/",
       "status": 301
+    },
+    {
+      "from": "/documentation/articles/viewing-your-site-on-a-testing-domain/",
+      "to": "/documentation/articles/testing-domain/",
+      "status": 301
+    },
+    {
+      "from": "/documentation/articles/hosting-your-site-on-a-custom-domain/",
+      "to": "/documentation/articles/what-is-a-custom-domain/",
+      "status": 301
+    },
+    {
+      "from": "/documentation/articles/hosting-your-site-on-a-subpath/",
+      "to": "/documentation/articles/host-your-site-on-a-subpath/",
+      "status": 301
+    },
+    {
+      "from": "/documentation/articles/https-support-for-your-sites-hosted-on-cloudcannon/",
+      "to": "/documentation/articles/add-an-auto-generated-ssl-certificate/",
+      "status": 301
+    },
+    {
+      "from": "/documentation/articles/using-cloudcannon-dns-to-configure-your-custom-domain/",
+      "to": "/documentation/articles/configure-cloudcannon-dns/",
+      "status": 301
+    },
+    {
+      "from": "/documentation/articles/using-external-dns-to-configure-your-custom-domain/",
+      "to": "/documentation/articles/configure-external-dns/",
+      "status": 301
     }
   ]
 }

_common_content/starter-guides/build-your-site.mdx

@@ -7,7 +7,7 @@ parameters: {}
   Building is an optional step. If your Site is dynamic, or you only want to use CloudCannon as a CMS for your Git repository, you don’t need to build. For more information, please read our guide on using [CloudCannon in Headless Mode](/documentation/guides/headless-starter-guide/).
 </comp.Notice>
 
-A "build" is when CloudCannon converts all your Site files into a single, functional website. Building your Site in CloudCannon enables you to check all your files function well together, preview screenshots of your pages in the [Collection](/documentation/articles/what-is-a-collection/) browser, view your Site live on a [Testing](/documentation/articles/viewing-your-site-on-a-testing-domain/) and [Custom Domain](/documentation/articles/hosting-your-site-on-a-custom-domain/), and use the [Visual Editor](/documentation/articles/the-visual-editor/) for an intuitive editing experience.
+A "build" is when CloudCannon converts all your Site files into a single, functional website. Building your Site in CloudCannon enables you to check all your files function well together, preview screenshots of your pages in the [Collection](/documentation/articles/what-is-a-collection/) browser, view your Site live on a [Testing](/documentation/articles/testing-domain/) and [Custom Domain](/documentation/articles/what-is-a-custom-domain/), and use the [Visual Editor](/documentation/articles/the-visual-editor/) for an intuitive editing experience.
 
 When you are ready to set up builds, click the *Return to setup* button in the *Site Navigation*. This will take you back to the *Summary* tab on the *Status* page.
 
@@ -35,7 +35,7 @@ You can monitor the outcome of your first build on the *Builds* tab of the *Stat
 
 After a successful first build, CloudCannon will build your Site every time it syncs an update from your repository, or when you [choose to trigger a build](/documentation/articles/what-is-a-site-build/#starting-a-build). This ensures your most recent content is always live.
 
-Now's a great time to look at your Site on your [Testing Domain](/documentation/articles/viewing-your-site-on-a-testing-domain/). Click the *Live site preview* button in your *Site Navigation*. This will open your unique *.cloudvent.net* address.
+Now's a great time to look at your Site on your [Testing Domain](/documentation/articles/testing-domain/). Click the *Live site preview* button in your *Site Navigation*. This will open your unique *.cloudvent.net* address.
 
 If your build fails for any reason, CloudCannon will suggest common solutions to troubleshoot your build on the *Summary* tab of the *Status* page. You can also read your [build output logs](/documentation/articles/what-is-a-site-build/#reading-your-build-output-logs) to diagnose your error.
 

_common_content/starter-guides/next-steps.mdx

@@ -13,7 +13,7 @@ parameters:
 
   ## Hosting
 
-  CloudCannon is an all-in-one Content Management System with hosting included. Every site has its own <a href="https://cloudcannon.com/documentation/articles/viewing-your-site-on-a-testing-domain/" target="_blank" rel="noopener">.cloudvent.net domain name</a> and is hosted on a super-fast Content Delivery Network (CDN) supported by Cloudflare. For a production site, you can <a href="https://cloudcannon.com/documentation/articles/hosting-your-site-on-a-custom-domain/" target="_blank" rel="noopener">point your domain to your site</a> or use <a href="https://cloudcannon.com/documentation/articles/using-cloudcannon-dns-to-configure-your-custom-domain/" target="_blank" rel="noopener">CloudCannon DNS</a> to automate the setup.
+  CloudCannon is an all-in-one Content Management System with hosting included. Every site has its own [Testing Domain](/documentation/articles/testing-domain/) and is hosted on a super-fast Content Delivery Network (CDN) supported by Cloudflare. For a production site, you can point your [Custom Domain](/documentation/articles/what-is-a-custom-domain/) at your Site or use [CloudCannon DNS](/documentation/articles/configure-cloudcannon-dns/) to automate the setup.
 
   All sites receive an SSL certificate, can easily scale to handle any amount of traffic, and offer <a href="https://cloudcannon.com/documentation/articles/configuring-custom-routing/#custom-headers" target="_blank" rel="noopener">custom routing and headers</a>, <a href="https://cloudcannon.com/documentation/articles/getting-started-with-forms-on-cloudcannon/" target="_blank" rel="noopener">form submissions</a>, and <a href="https://cloudcannon.com/documentation/articles/adding-password-authentication-to-your-site/" target="_blank" rel="noopener">various authentication options</a>.
 </comp.Slot>

_common_content/starter-guides/tour-cloudcannon.mdx

@@ -27,7 +27,7 @@ In this guide we'll look at <a href="https://jovial-pipe.cloudvent.net/" target=
   * **Avatars** — The avatars for any team members active on your Site. Clicking on an avatar will show a list of files they have open, with an eye icon for file they are *Viewing* and a pencil for *Editing*.
   * **The Save button** — Opens the *Review your changes* modal and allows you to commit changes to your Git repository.
   * **The Publish button** — If your Site has a [publish branch](/documentation/articles/connect-a-publish-branch/), this button allows you to create a Pull Request or immediately merge your changes from this Site to any Sites it publishes to.
-  * **The Live site preview button** — Opens your [Testing Domain](/documentation/articles/viewing-your-site-on-a-testing-domain/) or your [Custom Domain](/documentation/articles/hosting-your-site-on-a-custom-domain/), if you have one.
+  * **The Live site preview button** — Opens your [Testing Domain](/documentation/articles/testing-domain/) or your [Custom Domain](/documentation/articles/what-is-a-custom-domain/), if you have one.
   * **Site Dashboard** — Your Site home page, showing a preview of your last build and recent activity on your Site.
   * **Collections** — Groups of related content, such as a folder of blog articles, Staff Member profiles, or product pages.
   * **Developer Tools** — Tools for managing your Site, including the *Status* page, file browser, and *Site Settings*.
@@ -42,7 +42,7 @@ In this guide we'll look at <a href="https://jovial-pipe.cloudvent.net/" target=
 
   There are three tabs on your Dashboard: *Summary*, *Activity*, and *Usage*.
 
-  On the *Summary* tab you'll find your *Live URL* (either the [Testing Domain](/documentation/articles/viewing-your-site-on-a-testing-domain/) or your [Custom Domain](/documentation/articles/hosting-your-site-on-a-custom-domain/), if you have one), a preview of your Site's homepage generated during your last build, and a list of recent activity on your Site. There will also be buttons to open your home page in the Visual Editor, the *Publishing* page, and recently opened files.
+  On the *Summary* tab you'll find your *Live URL* (either the [Testing Domain](/documentation/articles/testing-domain/) or your [Custom Domain](/documentation/articles/what-is-a-custom-domain/), if you have one), a preview of your Site's homepage generated during your last build, and a list of recent activity on your Site. There will also be buttons to open your home page in the Visual Editor, the *Publishing* page, and recently opened files.
 
   <comp.Notice info_type="info">
                           Because you have not built your Site yet, the preview of your homepage will be missing. We'll cover building your Site later in this guide.

_data/article_topics.yml

@@ -1,21 +1,45 @@
-- Account Settings
+- Account
+- Assets
+- Authentication
 - Beta
+- Billing
+- Branding
 - Builds
+- Editing
 - Editing interfaces
 - Client Sharing
 - Collections
 - Configuration file
+- Custom Domains
 - Custom Permission Groups
+- Data previews
+- DNS
 - Flags
+- Forms
 - Headless Mode
+- Hosting
 - Inputs
 - Introduction
+- Invoices
+- Logging In
+- Migration
 - Multi-factor Authentication
 - Organizations
 - Partner Program
+- Performance
 - Permission Groups
 - Projects
+- Publishing
+- Sharing
 - Sites
+- Site Navigation
 - Site Sharing
+- Snippets
+- Support
+- SSL/TLS Certificates
 - SSO/SAML
-- Team members
+- Syncing
+- Team members
+- Testing Domain
+- Visual Editing
+- Webhooks

_data/navigation.yml

@@ -85,9 +85,6 @@ headings:
               - set-the-path-for-new-files
               - configure-the-add-button-in-collections
               - schemas-reference
-      - _type: items
-        articles:
-          - editing-your-files
       - _type: group
         name: Making changes
         items:
@@ -385,18 +382,34 @@ headings:
     items:
       - _type: items
         articles:
-          - viewing-your-site-on-a-testing-domain
+          - introduction-to-hosting
+          - what-is-web-hosting
+          - testing-domain
+      - _type: group
+        name: Custom Domains
+        items:
+          - _type: items
+            articles:
+              - what-is-a-custom-domain
+              - add-a-custom-domain
+              - add-a-subdomain
+              - host-your-site-on-a-subpath
+      - _type: group
+        name: DNS
+        items:
+          - _type: items
+            articles:
+              - what-is-dns
+              - configure-cloudcannon-dns
+              - configure-external-dns
       - _type: group
-        name: Custom domains
+        name: SSL
         items:
           - _type: items
             articles:
-              - hosting-your-site-on-a-custom-domain
-              - hosting-your-site-on-a-subpath
-              - https-support-for-your-sites-hosted-on-cloudcannon
+              - what-is-an-ssl-certificate
+              - add-an-auto-generated-ssl-certificate
               - add-a-custom-ssl-certificate
-              - using-cloudcannon-dns-to-configure-your-custom-domain
-              - using-external-dns-to-configure-your-custom-domain
       - _type: group
         name: Configuring routing
         items:

_keys/collections-config-new-preview-url.yml

@@ -11,9 +11,9 @@ key_description: >-
 
 
   This key does not affect the URL for your [Testing
-  Domain](/documentation/articles/viewing-your-site-on-a-testing-domain/) or
+  Domain](/documentation/articles/testing-domain/) or
   [Custom
-  Domain](/documentation/articles/hosting-your-site-on-a-custom-domain/).
+  Domain](/documentation/articles/what-is-a-custom-domain/).
 
 
   This key has no default.

_keys/collections-config-url.yml

@@ -7,9 +7,9 @@ key_description: >-
   This key defines the output URL for files in a given Collection. CloudCannon
   uses the output URL in the [Visual
   Editor](/documentation/articles/the-visual-editor/), and on your [Testing
-  Domain](/documentation/articles/viewing-your-site-on-a-testing-domain/) and
+  Domain](/documentation/articles/testing-domain/) and
   [Custom
-  Domain](/documentation/articles/hosting-your-site-on-a-custom-domain/).
+  Domain](/documentation/articles/what-is-a-custom-domain/).
 
 
   Values for this key can be a mix of plain text and template strings, and

articles/add-a-custom-domain.mdx

@@ -0,0 +1,47 @@
+---
+_schema: default
+_uuid: 6b2315f7-78a9-4536-baa2-9446ddfa0246
+_created_at: '2021-09-15 23:13:40 +0000'
+title: Add a Custom Domain
+nav_title: Add a Custom Domain
+published: true
+image: >-
+  https://cc-dam.imgix.net/documentation/images/default-thumbnail/2023-Q4/CloudCannon-Documentation-Thumbnail.png
+description: Learn how to add your own domain name to your Site on CloudCannon.
+article_category:
+  - Instructions
+article_topic:
+  - Custom Domains
+tags:
+  - Hosting
+  - Sites
+  - Guides
+related_articles:
+  - hosting-your-site-on-a-subpath
+  - using-cloudcannon-dns-to-configure-your-custom-domain
+  - using-external-dns-to-configure-your-custom-domain
+related_links:
+---
+A [Custom Domain](/documentation/articles/what-is-a-custom-domain/) is a unique address used to identify a website. You can purchase a Domain Name from a Domain Registrar.
+
+To add a Custom Domain to a Site in CloudCannon:
+
+1. Open the Site to which you want to add the Custom Domain.
+2. Navigate to the *Custom Domain* page under *Site Settings*.
+3. Select the *Add new custom domain* option in the *Choose your hosting option* dropdown.
+4. In the *Domain Name* text field, enter the domain and tld of you want to connect to this Site (e.g., example.com).
+5. Click the *Add Domain* button.
+
+CloudCannon will connect your Custom Domain to your Site.
+
+<comp.DocsImage path="https://cc-dam.imgix.net/documentation/images/hosting/add-a-custom-domain/2024-11/CloudCannon-Documentation-Add-Custom-Domain-Site-Settings.png" alt="A screenshot of the Custom Domain page under Site Settings shows the Choose your hosting option dropdown and a Domain name text field." title="The Custom Domain page" type="screenshot"/>
+
+The domain will now appear in your *Domain browser*, which you can access from your *Organization Dashboard*.
+
+<comp.DocsImage path="https://cc-dam.imgix.net/documentation/images/hosting/add-a-custom-domain/2024-11/CloudCannon-Documentation-Domains-Browser-Page.png" alt="A screenshot of the Domain Browser shows four Domain cards with metadata for connected Sites, DNS, and SSL certificate expiry date." title="The Domain Browser" type="screenshot"/>
+
+To see your Site content live on your domain, you will need to set up your [DNS](/documentation/articles/what-is-dns/). For more information, please read our documentation on [configuring CloudCannon DNS](/documentation/articles/configure-cloudcannon-dns/) (recommended) or [configuring external DNS](/documentation/articles/configure-external-dns/).
+
+We also recommend adding an [SSL certificate](/documentation/articles/what-is-an-ssl-certificate/) to your Site. For more information, please read our documentation on [adding an auto-generated SSL certificate](/documentation/articles/add-an-auto-generated-ssl-certificate/) or [adding a custom SSL certificate](/documentation/articles/add-a-custom-ssl-certificate/).
+
+To stop hosting your Site on a Custom Domain, navigate to the *Danger zone* tab on the *Custom Domain* page and click the *Remove Custom Domain* button.

articles/add-a-custom-ssl-certificate.mdx

@@ -13,21 +13,48 @@ description: >-
 article_category:
   - Instructions
 article_topic:
-tags:
-  - hosting
-  - ssl
+  - Custom Domains
+  - SSL/TLS Certificates
+  - Hosting
+tags: []
 related_articles: []
 related_links:
 ---
-Only sites with [Custom Domains](/documentation/articles/hosting-your-site-on-a-custom-domain/) can add custom SSL certificates.
+<comp.Notice info_type="important">
+  Managing your SSL certificate on CloudCannon requires you to host your Site through CloudCannon. If you are hosting your Site through an external service, please review their documentation on SSL certification.
+</comp.Notice>
 
-To add a new custom SSL certificate:
+You can purchase a custom SSL certificate from a trusted third-party provider.
 
-1. Navigate to the *Custom Domain* page under *Site Settings*, and click on the *SSL* tab.
-2. Click on the *Custom SSL certificate* dropdown and select the *New custom SSL certificate* option.
-3. In the *Add SSL certificate* modal, enter the details for Name, Expires, Public Key, Private Key, Certificate Chain.
-4. Click the *Add SSL certificate* button.
-5. Click the *Update SSL* button.
+You need the following details to add your custom SSL certificate to a [Custom Domain](/documentation/articles/what-is-a-custom-domain/) on CloudCannon.
+
+* Name (i.e. Domain Name)
+* Expiry Date
+* Public Key
+* Private Key
+* Certificate Chain
+
+<comp.Notice info_type="important">
+  Your private key should only be given to your DNS provider. Do not write down your Private key in a publicly accessible or unsecure place. If you think the security of your Private key has been compromized, please generate a new SSL certificate.
+</comp.Notice>
+
+SSL certificates last for about a year and should be renewed at yearly intervals to maintain your website's security. You can renew you SSL certificate more often, but most website do not require this level of security.
+
+Before you add an SSL certificate to your Site, you must [add a Custom Domain](/documentation/articles/add-a-custom-domain/) to your [Organization](/documentation/articles/what-is-an-organization/).
+
+<comp.Notice info_type="info">
+  If you have recently added your Custom Domain to your Site, CloudCannon may need a few minutes to fetch your domain details before you can add an SSL certificate. If this process takes more than a few minutes, please contact our friendly [support team](/support/).
+</comp.Notice>
+
+To add a custom SSL certificate to your Site:
+
+1. Navigate to the *SSL* tab on the *Custom Domain* page, under *Site Settings*.
+2. Select a version number in the *Minimum TLS Version* dropdown.
+3. Select the *DNS Text Record* option from the *Validation Method* dropdown.
+4. Select the *New custom SSL certificate* option in the *Custom SSL certificate* dropdown.
+5. In the *Add SSL certificate* modal, enter the details for Name, Expires, Public Key, Private Key, Certificate Chain.
+6. Click the *Add SSL certificate* button.
+7. Click the *Update SSL* button.
 
 <comp.DocsImage path="https://cc-dam.imgix.net/documentation/images/hosting/ssl/2024-08/CloudCannon-Documentation-Add-SSL-Certificate-Modal.png" alt="A screenshot of the Add SSL Certificate modal shows fields for Name, Expires, Public Key, Private Key, Certificate Chain." title="The Add SSL Certificate modal" type="screenshot"/>