From b0a57e5c3e3efbffc29e6f27c08ffa0834e87a3b Mon Sep 17 00:00:00 2001 From: Tom Limoncelli Date: Wed, 30 Jul 2025 20:43:42 -0400 Subject: [PATCH] DOCS: Improve docs and error messages related to apex domains (#3690) --- commands/types/dnscontrol.d.ts | 8 ++++---- documentation/language-reference/top-level-functions/D.md | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/commands/types/dnscontrol.d.ts b/commands/types/dnscontrol.d.ts index 3bbd6a1b7..4a2e7857d 100644 --- a/commands/types/dnscontrol.d.ts +++ b/commands/types/dnscontrol.d.ts @@ -690,10 +690,10 @@ declare function CNAME(name: string, target: string, ...modifiers: RecordModifie * ); * ``` * - * **What is "@"** `@` is a special name that means the domain itself, otherwise - * known as the domain's apex, the bare domain, or the naked domain. In the - * above example, `example.com` has an `A` record at the apex of the domain - * (`"1.2.3.4"`). + * **What is "@"?** The label `@` is a special name that means the domain itself, + * otherwise known as the domain's apex, the bare domain, or the naked domain. + * In other words, if you want to put a DNS record at the apex of a domain, use an `"@"` for the label, not an empty string (`""`). + * In the above example, `example.com` has an `A` record with the value `"1.2.3.4"` at the apex of the domain. * * # Split Horizon DNS * diff --git a/documentation/language-reference/top-level-functions/D.md b/documentation/language-reference/top-level-functions/D.md index ec0c4a791..beb5ba931 100644 --- a/documentation/language-reference/top-level-functions/D.md +++ b/documentation/language-reference/top-level-functions/D.md @@ -47,10 +47,10 @@ D("other-example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER), {% endcode %} {% hint style="info" %} -**What is "@"** `@` is a special name that means the domain itself, otherwise -known as the domain's apex, the bare domain, or the naked domain. In the -above example, `example.com` has an `A` record at the apex of the domain -(`"1.2.3.4"`). +**What is "@"?** The label `@` is a special name that means the domain itself, +otherwise known as the domain's apex, the bare domain, or the naked domain. +In other words, if you want to put a DNS record at the apex of a domain, use an `"@"` for the label, not an empty string (`""`). +In the above example, `example.com` has an `A` record with the value `"1.2.3.4"` at the apex of the domain. {% endhint %} # Split Horizon DNS