From eea87509e3b94d3f742e25c5101789a7475cb2f9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 00:16:41 +0000 Subject: [PATCH 1/5] docs: update CNAME target to docs.mintlify.builders --- customize/custom-domain.mdx | 2 +- es/customize/custom-domain.mdx | 2 +- fr/customize/custom-domain.mdx | 2 +- zh/customize/custom-domain.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx index cb19f3e26..5de84518d 100644 --- a/customize/custom-domain.mdx +++ b/customize/custom-domain.mdx @@ -38,7 +38,7 @@ To host your documentation on a custom domain: 2. Create a new DNS record with the following values: ```text -CNAME | docs | cname.mintlify-dns.com. +CNAME | docs | docs.mintlify.builders ``` diff --git a/es/customize/custom-domain.mdx b/es/customize/custom-domain.mdx index e333caa22..0fa5eb382 100644 --- a/es/customize/custom-domain.mdx +++ b/es/customize/custom-domain.mdx @@ -36,7 +36,7 @@ Para alojar tu documentación en un dominio personalizado: 2. Crea un nuevo registro DNS con los siguientes valores: ```text -CNAME | docs | cname.mintlify-dns.com. +CNAME | docs | docs.mintlify.builders ``` diff --git a/fr/customize/custom-domain.mdx b/fr/customize/custom-domain.mdx index 05621cda6..8e37545b4 100644 --- a/fr/customize/custom-domain.mdx +++ b/fr/customize/custom-domain.mdx @@ -36,7 +36,7 @@ Pour héberger votre documentation sur un domaine personnalisé : 2. Créez un nouvel enregistrement DNS avec les valeurs suivantes : ```text -CNAME | docs | cname.mintlify-dns.com. +CNAME | docs | docs.mintlify.builders ``` diff --git a/zh/customize/custom-domain.mdx b/zh/customize/custom-domain.mdx index e09b2c974..5f1fd9d36 100644 --- a/zh/customize/custom-domain.mdx +++ b/zh/customize/custom-domain.mdx @@ -36,7 +36,7 @@ keywords: ["自定义域名配置", "DNS 配置", "CNAME 记录", "TLS 证书"] 2. 新建一条 DNS 记录，并按以下值进行设置： ```text -CNAME | docs | cname.mintlify-dns.com. +CNAME | docs | docs.mintlify.builders ``` From c28889fbc032f215fa0a2aaf73be224eb3730117 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 00:29:40 +0000 Subject: [PATCH 2/5] docs: note TXT records and SSL pre-provisioning for zero-downtime domain migration --- .pr-body.md | 1 + customize/custom-domain.mdx | 4 ++++ es/customize/custom-domain.mdx | 4 ++++ fr/customize/custom-domain.mdx | 4 ++++ zh/customize/custom-domain.mdx | 4 ++++ 5 files changed, 17 insertions(+) create mode 100644 .pr-body.md diff --git a/.pr-body.md b/.pr-body.md new file mode 100644 index 000000000..9654f05f0 --- /dev/null +++ b/.pr-body.md @@ -0,0 +1 @@ +Updates the CNAME record value from `cname.mintlify-dns.com` to `docs.mintlify.builders` in the custom domain instructions across EN, ES, FR, and ZH versions. \ No newline at end of file diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx index 5de84518d..33115a37f 100644 --- a/customize/custom-domain.mdx +++ b/customize/custom-domain.mdx @@ -45,6 +45,10 @@ CNAME | docs | docs.mintlify.builders Each domain provider has different ways to add DNS records. Refer to your domain provider's documentation for specific instructions. + + If you are migrating an existing domain and want zero downtime, add the verification `TXT` records before updating your `CNAME`, then wait until SSL/TLS certificates are pre-provisioned before cutting over. Switching the `CNAME` before certificates are issued causes HTTPS requests to fail until provisioning completes. + + ### DNS propagation 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 is configured correctly using [DNSChecker](https://dnschecker.org). diff --git a/es/customize/custom-domain.mdx b/es/customize/custom-domain.mdx index 0fa5eb382..046ea12b5 100644 --- a/es/customize/custom-domain.mdx +++ b/es/customize/custom-domain.mdx @@ -43,6 +43,10 @@ CNAME | docs | docs.mintlify.builders Cada proveedor de dominios tiene diferentes formas de agregar registros DNS. Consulta la documentación de tu proveedor de dominios para obtener instrucciones específicas. + + Si estás migrando un dominio existente y quieres cero tiempo de inactividad, agrega los registros `TXT` de verificación antes de actualizar tu `CNAME` y espera a que los certificados SSL/TLS estén pre-provisionados antes de hacer el cambio. Cambiar el `CNAME` antes de que se emitan los certificados provoca que las solicitudes HTTPS fallen hasta que se complete el aprovisionamiento. + +
### Propagación de DNS diff --git a/fr/customize/custom-domain.mdx b/fr/customize/custom-domain.mdx index 8e37545b4..5a774eb99 100644 --- a/fr/customize/custom-domain.mdx +++ b/fr/customize/custom-domain.mdx @@ -43,6 +43,10 @@ CNAME | docs | docs.mintlify.builders Chaque fournisseur de domaine a des méthodes différentes pour ajouter des enregistrements DNS. Consultez la documentation de votre fournisseur de domaine pour des instructions spécifiques. + + Si vous migrez un domaine existant et souhaitez aucun temps d'arrêt, ajoutez les enregistrements `TXT` de vérification avant de mettre à jour votre `CNAME`, puis attendez que les certificats SSL/TLS soient pré-provisionnés avant de basculer. Modifier le `CNAME` avant l'émission des certificats entraîne l'échec des requêtes HTTPS jusqu'à la fin du provisionnement. + +
### Propagation du DNS diff --git a/zh/customize/custom-domain.mdx b/zh/customize/custom-domain.mdx index 5f1fd9d36..68cd4a9d7 100644 --- a/zh/customize/custom-domain.mdx +++ b/zh/customize/custom-domain.mdx @@ -43,6 +43,10 @@ CNAME | docs | docs.mintlify.builders 不同域名提供商添加 DNS（域名系统）记录的方式各不相同。请查阅你的域名提供商文档获取具体操作指南。 + + 如果你正在迁移现有域名并希望实现零停机，请先添加验证用的 `TXT` 记录，再更新 `CNAME`，并等待 SSL/TLS 证书预配置完成后再进行切换。如果在证书签发之前就更改 `CNAME`，HTTPS 请求将会失败，直到证书配置完成。 + +
### DNS 传播 From d292919eba85d851ccfd7605d526adf666b0aecb Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 02:07:08 +0000 Subject: [PATCH 3/5] fix: use cname.mintlify.builders instead of docs.mintlify.builders --- customize/custom-domain.mdx | 2 +- es/customize/custom-domain.mdx | 2 +- fr/customize/custom-domain.mdx | 2 +- zh/customize/custom-domain.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx index 33115a37f..157c0b9ba 100644 --- a/customize/custom-domain.mdx +++ b/customize/custom-domain.mdx @@ -38,7 +38,7 @@ To host your documentation on a custom domain: 2. Create a new DNS record with the following values: ```text -CNAME | docs | docs.mintlify.builders +CNAME | docs | cname.mintlify.builders ``` diff --git a/es/customize/custom-domain.mdx b/es/customize/custom-domain.mdx index 046ea12b5..353440970 100644 --- a/es/customize/custom-domain.mdx +++ b/es/customize/custom-domain.mdx @@ -36,7 +36,7 @@ Para alojar tu documentación en un dominio personalizado: 2. Crea un nuevo registro DNS con los siguientes valores: ```text -CNAME | docs | docs.mintlify.builders +CNAME | docs | cname.mintlify.builders ``` diff --git a/fr/customize/custom-domain.mdx b/fr/customize/custom-domain.mdx index 5a774eb99..f5d0c8217 100644 --- a/fr/customize/custom-domain.mdx +++ b/fr/customize/custom-domain.mdx @@ -36,7 +36,7 @@ Pour héberger votre documentation sur un domaine personnalisé : 2. Créez un nouvel enregistrement DNS avec les valeurs suivantes : ```text -CNAME | docs | docs.mintlify.builders +CNAME | docs | cname.mintlify.builders ``` diff --git a/zh/customize/custom-domain.mdx b/zh/customize/custom-domain.mdx index 68cd4a9d7..08c252d34 100644 --- a/zh/customize/custom-domain.mdx +++ b/zh/customize/custom-domain.mdx @@ -36,7 +36,7 @@ keywords: ["自定义域名配置", "DNS 配置", "CNAME 记录", "TLS 证书"] 2. 新建一条 DNS 记录，并按以下值进行设置： ```text -CNAME | docs | docs.mintlify.builders +CNAME | docs | cname.mintlify.builders ``` From 8e9ce40ab295e6d526381a29c180215decd06ace Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 02:16:26 +0000 Subject: [PATCH 4/5] chore: remove accidentally committed .pr-body.md --- .pr-body.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 .pr-body.md diff --git a/.pr-body.md b/.pr-body.md deleted file mode 100644 index 9654f05f0..000000000 --- a/.pr-body.md +++ /dev/null @@ -1 +0,0 @@ -Updates the CNAME record value from `cname.mintlify-dns.com` to `docs.mintlify.builders` in the custom domain instructions across EN, ES, FR, and ZH versions. \ No newline at end of file From c613a5676e8654d65e32a4aa17ff4df660810ea8 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 4 May 2026 12:59:27 -0700 Subject: [PATCH 5/5] Apply suggestion from @ethanpalm --- customize/custom-domain.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx index 157c0b9ba..1a777548d 100644 --- a/customize/custom-domain.mdx +++ b/customize/custom-domain.mdx @@ -46,7 +46,7 @@ CNAME | docs | cname.mintlify.builders - If you are migrating an existing domain and want zero downtime, add the verification `TXT` records before updating your `CNAME`, then wait until SSL/TLS certificates are pre-provisioned before cutting over. Switching the `CNAME` before certificates are issued causes HTTPS requests to fail until provisioning completes. + If you migrate an existing domain and want zero downtime, add the verification `TXT` records before updating your `CNAME`. Then wait until SSL/TLS certificates pre-provision before cutting over. Switching the `CNAME` before certificates are issued causes HTTPS requests to fail until provisioning completes. ### DNS propagation