Expand custom domain section in quickstart guide

quickstart.mdx

@@ -4,10 +4,10 @@
 keywords: ["quickstart","deploy","get started","first steps"]
 ---
 
 After completing this guide, you will have a live documentation site ready to customize and expand.
 
 <Info>
   **Prerequisites**: Before you begin, [create an account](https://mintlify.com/start) and complete onboarding.
 </Info>
 
 ## Getting started
@@ -36,7 +36,7 @@
 
 Your site's URL is available immediately. Use this URL for testing and sharing with your team while you are setting up your docs site.
 
 ### Install the GitHub App
 
 Mintlify provides a GitHub App that automates deployment when you push changes to your repository.
 
@@ -69,11 +69,11 @@
 ### Authorize your GitHub account
 
 1. Navigate to **Settings** in your Mintlify dashboard.
 2. Select **My Profile** from the sidebar.
 3. Select **Authorize GitHub account**. This opens a new tab to the GitHub authorization page.
 
 <Info>
   An admin for your GitHub organization may need to authorize your account depending on your organization settings.
 </Info>
 
 ## Editing workflows
@@ -92,13 +92,13 @@
 
 The code-based workflow integrates with your existing development environment and Git repositories. This workflow is best for technical teams who want to manage documentation alongside code.
 
 ### Install the CLI
 
 <Info>
   **Prerequisite**: The CLI requires [Node.js](https://nodejs.org/en) v20.17.0 or higher through v24. LTS versions are preferred.
 </Info>
 
 To work locally with your documentation, install the Command Line Interface (CLI), called [mint](https://www.npmjs.com/package/mint), by running this command in your terminal:
 
 <CodeGroup>
 
@@ -170,7 +170,7 @@
 
 Mintlify automatically detects the changes, builds your documentation, and deploys the updates to your site. Monitor the deployment status in your GitHub repository commit history or the [dashboard](https://dashboard.mintlify.com).
 
 After the deployment completes, your latest update will be available at `<your-project-name>.mintlify.app`.
 
 <Card title="Jump to adding a custom domain" icon="arrow-down" horizontal href="#adding-a-custom-domain">
   Optionally, skip the web editor workflow and jump to adding a custom domain.
@@ -178,7 +178,7 @@
 
 ## Web editor workflow
 
 The web editor workflow provides a what-you-see-is-what-you-get (WYSIWYG) interface for creating and editing documentation. This workflow is best for people who want to work in their web browser without additional local development tools.
 
 ### Access the web editor
 
@@ -186,7 +186,7 @@
 2. Select **Editor** on the left sidebar.
 
 <Info>
   If you have not installed the GitHub App, you will be prompted to install the app when you open the web editor.
 </Info>
 
 <Frame>
@@ -205,11 +205,11 @@
 
 ### Edit the documentation
 
 In the web editor, you can navigate through your documentation files in the sidebar. Let's update the introduction page:
 
 Find and select `index.mdx` in the file explorer.
 
 Then, in the editor, update the title field to "Hello World".
 
 <Frame>
   <img
@@ -239,13 +239,17 @@
   Use branches to preview and review changes through pull requests before deploying to your live site.
 </Tip>
 
 For more details about using the web editor, including using branches and pull requests to collaborate and preview changes, see our [web editor documentation](/editor).
 
 ## Adding a custom domain
 
 While your `<your-project-name>.mintlify.app` subdomain works well for testing and development, most teams prefer using a custom domain for production documentation.
 
-To add a custom domain, navigate to the [Domain Setup](https://dashboard.mintlify.com/settings/deployment/custom-domain) page in your dashboard.
+### Add your domain in the dashboard
+
+1. Navigate to the [Custom domain setup](https://dashboard.mintlify.com/settings/deployment/custom-domain) page in your dashboard.
+2. Enter your domain name (for example, `docs.yourcompany.com`).
+3. Click **Add domain**.
 
 <Frame>
   <img
@@ -261,21 +265,43 @@
   />
 </Frame>
 
-Enter your domain (for example, `docs.yourcompany.com`) and follow the provided instructions to configure DNS settings with your domain provider.
+### Configure DNS settings
+
+On your domain provider's website, navigate to your domain's DNS settings and create a new CNAME record:
 
 <Table>
-  | Record Type | Name                | Value                | TTL  |
-  | ----------- | ------------------- | -------------------- | ---- |
-  | CNAME       | docs (or subdomain) | cname.vercel-dns.com | 3600 |
+  | Record Type | Name                | Value                   | TTL  |
+  | ----------- | ------------------- | ----------------------- | ---- |
+  | CNAME       | docs (or subdomain) | cname.mintlify-dns.com. | 3600 |
 </Table>
 
-<Info>
-  DNS changes can take up to 48 hours to propagate, though changes often complete much sooner.
-</Info>
+<Tip>
+  Each domain provider has different ways to add DNS records. Refer to your provider's documentation for specific instructions.
+</Tip>
+
+### Wait for DNS propagation and TLS provisioning
+
+DNS changes typically take 1-24 hours to propagate globally, though it can take up to 48 hours in some cases. You can verify your DNS configuration using [DNSChecker](https://dnschecker.org).
+
+Once your DNS records propagate, Mintlify automatically provisions a free SSL/TLS certificate for your domain. Your site is first accessible via HTTP, then HTTPS becomes available after certificate provisioning completes.
+
+<AccordionGroup>
+  <Accordion title="Cloudflare users">
+    If Cloudflare is your DNS provider, enable "Full (strict)" mode for SSL/TLS encryption. Also disable "Always Use HTTPS" in Edge Certificates settings to allow certificate validation.
+  </Accordion>
+  <Accordion title="Vercel users">
+    If Vercel is your domain provider, you must add a verification `TXT` record. This information appears on your dashboard after submitting your custom domain.
+  </Accordion>
+  <Accordion title="Using CAA records">
+    If your domain uses CAA (Certification Authority Authorization) records, add `0 issue "letsencrypt.org"` to authorize certificate issuance.
+  </Accordion>
+</AccordionGroup>
+
+For more details on custom domains, including setting canonical URLs for SEO, see the [custom domain documentation](/customize/custom-domain).
 
 ## Next steps
 
 Congratulations! You have successfully deployed your documentation site with Mintlify. Here are suggested next steps to enhance your documentation:
 
 <Card title="Configure your global settings" icon="settings" horizontal href="organize/settings">
   Configure site-wide styling, navigation, integrations, and more with the `docs.json` file.
@@ -309,5 +335,5 @@
     Deployment can take up to a few minutes. Check your GitHub Actions (for code-based workflow) or deployment logs in the Mintlify dashboard to ensure there are no build errors.
   </Accordion>
   <Accordion title="Custom domain not connecting">
     Verify that your DNS records are set up correctly and allow sufficient time for DNS propagation (up to 48 hours). You can use tools like [DNSChecker](https://dnschecker.org) to verify your CNAME record.
   </Accordion>