From 1637b40ab40439b12a2db822fc55dd355e4f8824 Mon Sep 17 00:00:00 2001 From: Rowena Date: Mon, 19 May 2025 09:42:47 +0200 Subject: [PATCH 1/2] fix(dns): reformat --- .../understanding-dns-records.mdx | 70 +++++++------------ 1 file changed, 27 insertions(+), 43 deletions(-) diff --git a/pages/domains-and-dns/reference-content/understanding-dns-records.mdx b/pages/domains-and-dns/reference-content/understanding-dns-records.mdx index 7b9aaaf533..97709a1f94 100644 --- a/pages/domains-and-dns/reference-content/understanding-dns-records.mdx +++ b/pages/domains-and-dns/reference-content/understanding-dns-records.mdx @@ -20,31 +20,27 @@ Information in DNS zones is categorized and organized through a list of [DNS rec Each of these records has a type, an expiration time (Time to Live - TTL) and a name. Certain types of records also have type-specific data. -### A record +## A record **A record** stands for **Address record**. It is mostly used to map domain names to the IPv4 address of a specific server. In other words, it allows to connect a domain name to the numerical IP address of a server where the website or online service is hosted. An A record ensures that when you type a website's name into your browser, your computer knows where to find that website on the internet. -### AAAA record +## AAAA record Just like an A record connects a domain to an IPv4 address, an **AAAA record** does the same thing for the newer IPv6 addresses. It allows devices to locate and communicate with websites and services using the IPv6 protocol. -### ALIAS record +## ALIAS record An ALIAS record works exactly like a [CNAME record](#cname-record) An ALIAS record could be useful if you want your domain name (not its subdomains) to point to a hostname. - You must end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given.
-
- Not ending your domain name with a trailing dot results in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution).
-
- For example, if you want `mydomain.com` to point to `mynewdomain.com`, you **must** write `mynewdomain.com.` in the **Hostname** field. Otherwise, the CNAME record will direct your users to `mynewdomain.com.mynewdomain.com`.
+Ensure you add a [trailing dot](#formatting-note-trailing-dot) when creating an ALIAS record. -### CAA record +## CAA record **CAA record** stands for **Certification Authority Authorization record**. It allows domain owners to specify which certificate authorities (CAs) are authorized to issue [SSL/TLS certificates](/domains-and-dns/concepts/#ssltls-certificates) for their domain. @@ -68,45 +64,33 @@ The CAA record provided with Domains and DNS includes the following components: * **128 or Issuer critical**: This flag means that any unrecognized tags will halt the certificate issuance, assuming the issuer is compliant to standards. -### CNAME record +## CNAME record **CNAME record** stands for **Canonical name record**. It is used to point subdomains to a hostname. A CNAME record does not directly [resolve](/domains-and-dns/concepts/#domain-name-resolution) to an IP address. Instead, it refers to whether the domain is an [absolute](/domains-and-dns/concepts/#fully-qualified-domain-name-fqdn) or [relative](/domains-and-dns/concepts/#partially-qualified-domain-name-pqdn) domain. - You must end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given.
-
- Not ending your domain name with a trailing dot results in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution).
-
- For example, if you want `mydomain.com` to point to `mynewdomain.com`, you **must** write `mynewdomain.com.` in the **Hostname** field. Otherwise, the CNAME record will direct your users to `mynewdomain.com.mynewdomain.com`.
+Ensure you add a [trailing dot](#formatting-note-trailing-dot) when creating a CNAME record. -### DNAME record +## DNAME record **DNAME record** stands for **Delegation name record**. It is used for domain name redirection and renaming. Unlike other DNS record types that map domain names to IP addresses, a DNAME record allows you to redirect an entire domain and all of its subdomains to a different domain name. You should configure a DNAME record if you want to rename or restructure a domain while ensuring that all of its subdomains are automatically redirected to the new domain. - You must end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given.
-
- Not ending your domain name with a trailing dot results in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution).
-
- For example, if you want `mydomain.com` to point to `mynewdomain.com`, you **must** write `mynewdomain.com.` in the **Hostname** field. Otherwise, the CNAME record will direct your users to `mynewdomain.com.mynewdomain.com`.
+Ensure you add a [trailing dot](#formatting-note-trailing-dot) when creating a DNAME record. -### MX record +## MX record **MX record** stands for **Mail exchange record**. It is used to specify the mail servers responsible for receiving and handling emails for a specific domain. For example, when sending an email to an address within your domain `my@domain.com`, your email server needs to determine where to deliver the emails. Your MX record provides this information by pointing to the receiver domain's mail servers that are designated to accept incoming emails. - You must end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given.
-
- Not ending your domain name with a trailing dot results in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution).
-
- For example, if you want `mydomain.com` to point to `mynewdomain.com`, you **must** write `mynewdomain.com.` in the **Hostname** field. Otherwise, the CNAME record will direct your users to `mynewdomain.com.mynewdomain.com`.
+Ensure you add a [trailing dot](#formatting-note-trailing-dot) when creating an MX record. -### NAPTR record +## NAPTR record **NAPTR record** stands for **Naming Authority Pointer record**. It provides instructions for translating a specific type of data into a different format. NAPTR records help devices and services such as Voice over Internet Protocol systems, find the appropriate servers or services to connect to. They essentially act as a guide, pointing out how to transform certain data to match what is needed for communication or service interaction. @@ -136,7 +120,7 @@ The NAPTR record provided with Domains and DNS includes the following components - **Replacement domain**: A replacement string that is used to replace the matched portion of the domain name based on the regular expression. -### NS record +## NS record **NS record** stands for **Name server record**. It is used to designate the authoritative name servers for a specific domain. @@ -144,28 +128,20 @@ When a DNS query is made for a domain's information (like its IP address), DNS r The authoritative name servers then provide the necessary DNS information to complete the query. - You must end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given.
-
- Not ending your domain name with a trailing dot results in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution).
-
- For example, if you want `mydomain.com` to point to `mynewdomain.com`, you **must** write `mynewdomain.com.` in the **Hostname** field. Otherwise, the CNAME record will direct your users to `mynewdomain.com.mynewdomain.com`.
+Ensure you add a [trailing dot](#formatting-note-trailing-dot) when creating a NS record. -### SRV record +## SRV record **SRV record** stands for **Service record**. It provides information about specific network services offered by a domain. It includes details like the service's protocol, port number, priority, weight, and the domain name of the server offering the service. SRV records help devices locate and connect to the right servers for specific services on the internet such as chat or phone services. - You must end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given.
-
- Not ending your domain name with a trailing dot results in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution).
-
- For example, if you want `mydomain.com` to point to `mynewdomain.com`, you **must** write `mynewdomain.com.` in the **Hostname** field. Otherwise, the CNAME record will direct your users to `mynewdomain.com.mynewdomain.com`.
+Ensure you add a [trailing dot](#formatting-note-trailing-dot) when creating a SRV record. -### TLSA record +## TLSA record **TLSA record** stands for **Transport Layer Security Authentication record**. It is used to associate a TLS certificate or public key with the specified domain name. @@ -173,8 +149,16 @@ TLSA records allow you to improve the security of encrypted connections by speci When a client connects to a server using TLS and encounters a TLSA record, it can use the information in the record to verify that the presented certificate matches the expected one. This adds an extra layer of security by making sure that encrypted connections are established with legitimate servers. -### TXT record +## TXT record **TXT record** stand for **Text record**. It consists of plain text data, and its content can be human-readable or machine-interpretable, depending on its intended purpose. -TXT records can be used for various purposes such as adding information, verification, authentication, and configuration settings to a domain. \ No newline at end of file +TXT records can be used for various purposes such as adding information, verification, authentication, and configuration settings to a domain. + +## Formatting note: trailing dot + +In the case of ALIAS, CNAME, DNAME, MX, NS and SRV records, you **must** end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given. + +Not ending your domain name with a trailing dot can result in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution). + +For example, if you create a CNAME record to point `mydomain.com` to `mynewdomain.com`, you must write `mynewdomain.com.` (with a trailing dot) in the Hostname field. Otherwise, the DNS resolver may try to resolve `mynewdomain.com.mydomain.com`, leading to incorrect behavior. \ No newline at end of file From 95ac04e05725fb47a42d825464cf6b666c06f91f Mon Sep 17 00:00:00 2001 From: Rowena Date: Mon, 19 May 2025 10:36:45 +0200 Subject: [PATCH 2/2] fix(dns): fix record --- .../reference-content/understanding-dns-records.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/domains-and-dns/reference-content/understanding-dns-records.mdx b/pages/domains-and-dns/reference-content/understanding-dns-records.mdx index 97709a1f94..1534d35db1 100644 --- a/pages/domains-and-dns/reference-content/understanding-dns-records.mdx +++ b/pages/domains-and-dns/reference-content/understanding-dns-records.mdx @@ -157,7 +157,7 @@ TXT records can be used for various purposes such as adding information, verific ## Formatting note: trailing dot -In the case of ALIAS, CNAME, DNAME, MX, NS and SRV records, you **must** end your domain with a **trailing dot** as this disables domain search, using only the complete domain name you have given. +In the case of ALIAS, CNAME, DNAME, MX, NS and SRV records, you **must** end your domain with a **trailing dot** to use only the complete hostname you have given. Not ending your domain name with a trailing dot can result in your domain being tried with a domain name appended to it, or even a list of domain names until one [resolves](/domains-and-dns/concepts/#domain-name-resolution).