From dcb1098f52d97d0e7c85f24924056fac22288345 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Wed, 27 Nov 2024 16:59:28 +0000 Subject: [PATCH 1/9] Move Concepts higher in get-started and add placeholder entry --- src/content/docs/dns/concepts.mdx | 6 +++++- src/content/docs/dns/get-started.mdx | 6 ++---- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index a29692a9c9c50fa..7b9482d5403b463 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -9,7 +9,11 @@ head: --- -This page defines and articulates key concepts that are relevant to the Cloudflare DNS service and are used in this documentation. For more concepts and broader descriptions, check out the [Cloudflare Learning Center](https://www.cloudflare.com/learning/dns/what-is-dns/). +This page defines and articulates key concepts that are relevant to the Cloudflare DNS service and are used in this documentation. For more concepts and broader descriptions, consider the [Cloudflare Learning Center](https://www.cloudflare.com/learning/dns/what-is-dns/). + +## Authoritative DNS provider and DNS setups + + ## Domain diff --git a/src/content/docs/dns/get-started.mdx b/src/content/docs/dns/get-started.mdx index 38c650c99c9a566..edf693a0a0cabd2 100644 --- a/src/content/docs/dns/get-started.mdx +++ b/src/content/docs/dns/get-started.mdx @@ -2,7 +2,7 @@ title: Get started pcx_content_type: navigation sidebar: - order: 2 + order: 1 head: - tag: title content: Get started with Cloudflare DNS @@ -11,7 +11,7 @@ head: import { GlossaryDefinition, Render } from "~/components"; -You can use Cloudflare DNS with a variety of [setups](/dns/zone-setups/). +You can use Cloudflare DNS with a variety of [setups](/dns/zone-setups/). For an overview of what these setups are and if you are not yet familiar with specific DNS terminology, refer to [Concepts](/dns/concepts/). In the most common setup (full), you [add your domain](/fundamentals/setup/manage-domains/add-site/), import your [DNS records](/dns/manage-dns-records/), and [update your nameservers](/dns/nameservers/update-nameservers/) to make Cloudflare your primary authoritative DNS provider. Once the setup is completed: @@ -33,8 +33,6 @@ The following links introduce important concepts and will guide you through acti - [How Cloudflare works](/fundamentals/concepts/how-cloudflare-works/): An overview of how Cloudflare works as a DNS provider and as a reverse proxy. -- [DNS concepts](/dns/concepts/): Fundamental concepts to help you understand DNS terminology. - - [DNS analytics](/dns/additional-options/analytics/): An overview of the different data sources and insights you can get when using Cloudflare DNS. - [Troubleshooting](/dns/troubleshooting/): A full resources list for when something is not working. \ No newline at end of file From 2adc2ee1f6e3702199125186d9f71f34493c6e6d Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 28 Nov 2024 15:51:06 +0000 Subject: [PATCH 2/9] Add Auth DNS and review concepts for Domain, Registrar, and Zone --- src/content/docs/dns/concepts.mdx | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index 7b9482d5403b463..b615f7c7ad9fcd7 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -11,23 +11,27 @@ head: This page defines and articulates key concepts that are relevant to the Cloudflare DNS service and are used in this documentation. For more concepts and broader descriptions, consider the [Cloudflare Learning Center](https://www.cloudflare.com/learning/dns/what-is-dns/). -## Authoritative DNS provider and DNS setups +## Domain +Also known as domain name, a domain is the string of text that identifies a specific website, such as `google.com` or `facebook.com`. Every time you access a website from your web browser, a DNS query takes place and the domain name is mapped to the actual IP address where the website is [hosted](/fundamentals/setup/manage-domains/). +## Registrar -## Domain +Before you can start using the Cloudflare DNS service, you must first have a domain. This is achieved by using a service called registrar. As explained in our [Learning Center](https://www.cloudflare.com/learning/dns/glossary/what-is-a-domain-name-registrar/), a registrar handles the reservation of domain names. -Also known as domain name, a domain is the string of text that identifies a specific website, such as `google.com` or `facebook.com`. Every time you access a website from your web browser, a DNS query takes place and the domain name is mapped to the actual IP address where the website is hosted. +Very often, the same company that offers domain registration also offers web hosting and DNS management. -## Registrar +Cloudflare offers at-cost domain registration through [Cloudflare Registrar](/registrar/). Every domain acquired through Cloudflare Registrar must also use Cloudflare as primary authoritative DNS. + +## Authoritative DNS -Before you can start using the Cloudflare DNS service, you must first have a domain. This is achieved by using a service called registrar. As explained in our [Learning Center](https://www.cloudflare.com/learning/dns/glossary/what-is-a-domain-name-registrar/), a registrar handles the reservation of domain names as well as the assignment of IP addresses for those domains. +Authoritative DNS refers to the service whose nameservers provide the final information mapping a hostname (such as `example.com` or `blog.example.com`) to the IP address that hosts the corresponding content or resources. -Cloudflare offers at-cost domain registration through [Cloudflare Registrar](/registrar/). +This is important because the performance of such authoritative DNS services determine how available, resilient, and performant your website or application is. Cloudflare DNS is an authoritative DNS service leveraging Cloudflare's global network. Refer to [How Cloudflare works](/fundamentals/concepts/how-cloudflare-works/) for details. ## Zone -DNS zone is an administrative concept used for delegating control over DNS settings for different domains, subdomains or a set of both. You can read more about this in the [specific Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). +DNS zone is an administrative concept used for delegating control over DNS settings for different domains. You can read more about this in the [specific Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). For the purpose of this documentation, keep in mind that each site added to a Cloudflare account is listed in the account home page as a zone. The exact properties and behaviors of your zone depend on its [setup option](/dns/zone-setups/). From 88b27692ef112998fca065d7630c08447245b846 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 28 Nov 2024 17:29:24 +0000 Subject: [PATCH 3/9] Move nameserver def higher and solve overlap with Auth DNS --- src/content/docs/dns/concepts.mdx | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index b615f7c7ad9fcd7..deb1281de8c3140 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -19,9 +19,15 @@ Also known as domain name, a domain is the string of text that identifies a spec Before you can start using the Cloudflare DNS service, you must first have a domain. This is achieved by using a service called registrar. As explained in our [Learning Center](https://www.cloudflare.com/learning/dns/glossary/what-is-a-domain-name-registrar/), a registrar handles the reservation of domain names. -Very often, the same company that offers domain registration also offers web hosting and DNS management. +Very often the same company that offers domain registration also offers web hosting and DNS management. -Cloudflare offers at-cost domain registration through [Cloudflare Registrar](/registrar/). Every domain acquired through Cloudflare Registrar must also use Cloudflare as primary authoritative DNS. +You can register a domain name at coast through [Cloudflare Registrar](/registrar/). Every domain acquired through Cloudflare Registrar must also use Cloudflare as [primary authoritative DNS](#authoritative-dns). + +## Nameserver + +Although the resolution of a DNS query involves a number of different servers, in this documentation nameserver usually refers to the Cloudflare authoritative nameservers. As explained in the [article about DNS server types](https://www.cloudflare.com/learning/dns/dns-server-types/), the authoritative nameserver is the last stop in the resolution of a DNS query. + +Refer to [Nameservers](/dns/nameservers/) for details on the different nameserver offerings. ## Authoritative DNS @@ -29,17 +35,15 @@ Authoritative DNS refers to the service whose nameservers provide the final info This is important because the performance of such authoritative DNS services determine how available, resilient, and performant your website or application is. Cloudflare DNS is an authoritative DNS service leveraging Cloudflare's global network. Refer to [How Cloudflare works](/fundamentals/concepts/how-cloudflare-works/) for details. -## Zone +## DNS setups -DNS zone is an administrative concept used for delegating control over DNS settings for different domains. You can read more about this in the [specific Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). -For the purpose of this documentation, keep in mind that each site added to a Cloudflare account is listed in the account home page as a zone. The exact properties and behaviors of your zone depend on its [setup option](/dns/zone-setups/). -## Nameserver +## Zone -Although the resolution of a DNS query involves a number of different servers, in this documentation nameserver usually refers to the Cloudflare authoritative nameservers. As explained in the [article about DNS server types](https://www.cloudflare.com/learning/dns/dns-server-types/), the authoritative nameserver is the last stop in the query, the server that returns the IP address for the requested domain. +DNS zone is an administrative concept used for delegating control over DNS settings for different domains. You can read more about this in the [specific Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). -When you have a domain using a [full setup](/dns/zone-setups/full-setup/), Cloudflare provides the authoritative nameservers for your domain. Refer to [Nameservers](/dns/nameservers/) for details on the different nameserver offerings. +For the purpose of this documentation, keep in mind that each domain added to a Cloudflare account is listed in the account home page as a zone. The exact properties and behaviors of your zone depend on its [DNS setup](/dns/zone-setups/). ## DNS records @@ -51,4 +55,4 @@ For more details about using DNS records within Cloudflare, refer to [Manage DNS DNSSEC stands for DNS Security Extensions. It increases security by adding cryptographic signatures to DNS records. These signatures can then be checked to verify that a record came from the correct DNS server, preventing anyone else from issuing false DNS records on your behalf and redirecting traffic intended for your domain. You can read more about it in the [article about DNS security](https://www.cloudflare.com/learning/dns/dns-security/). -For help setting up DNSSEC in Cloudflare, refer to [Enable DNSSEC](/dns/dnssec/). +For help setting up DNSSEC in Cloudflare, refer to [Enable DNSSEC](/dns/dnssec/). \ No newline at end of file From c2c18e9876e0cfcab152708e973debbddf4486b5 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Mon, 2 Dec 2024 14:34:20 +0000 Subject: [PATCH 4/9] Fill in DNS setups concept, applying Primary more prominently --- src/content/docs/dns/concepts.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index deb1281de8c3140..fe1adb8431aa036 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -37,7 +37,13 @@ This is important because the performance of such authoritative DNS services det ## DNS setups +It is also possible that one same company will use more than one DNS provider. Usually, this relates to making a domain even more resilient - if one provider faces an outage, the nameservers operated by the other DNS provider will most likely still be available. +In this context, you can have a primary DNS setup, when you use Cloudflare to manage your DNS records, or a [secondary DNS setup](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/), when your DNS records are managed on a different provider and Cloudflare simply receives zone transfers containing your DNS records. + +When you have a primary DNS setup, you can either use only Cloudflare (also known as [Full setup](/dns/zone-setups/full-setup/)), or you can use Cloudflare and another provider, where the other provider is the one to receive [outgoing zone transfers](/dns/zone-setups/zone-transfers/cloudflare-as-primary/) from Cloudflare. + +Finally, as Cloudflare also works as a [reverse proxy](/fundamentals/concepts/how-cloudflare-works/#how-cloudflare-works-as-a-reverse-proxy), partial (CNAME) setups can be used when you do not want Cloudflare to be [authoritative](#authoritative-dns) for your domain but you still want to proxy individual subdomains through Cloudflare. ## Zone From 1b10bd536dcf263bc6755b957c26ff5d6578a0b7 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Tue, 3 Dec 2024 13:13:58 +0000 Subject: [PATCH 5/9] Review concepts and missing link to partial-setup --- src/content/docs/dns/concepts.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index fe1adb8431aa036..e284a5be060a7cb 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -37,13 +37,13 @@ This is important because the performance of such authoritative DNS services det ## DNS setups -It is also possible that one same company will use more than one DNS provider. Usually, this relates to making a domain even more resilient - if one provider faces an outage, the nameservers operated by the other DNS provider will most likely still be available. +It is also possible that one same company will use more than one DNS provider. Usually, this relates to making a domain more resilient - if one provider faces an outage, the nameservers operated by the other DNS provider will most likely still be available. In this context, you can have a primary DNS setup, when you use Cloudflare to manage your DNS records, or a [secondary DNS setup](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/), when your DNS records are managed on a different provider and Cloudflare simply receives zone transfers containing your DNS records. When you have a primary DNS setup, you can either use only Cloudflare (also known as [Full setup](/dns/zone-setups/full-setup/)), or you can use Cloudflare and another provider, where the other provider is the one to receive [outgoing zone transfers](/dns/zone-setups/zone-transfers/cloudflare-as-primary/) from Cloudflare. -Finally, as Cloudflare also works as a [reverse proxy](/fundamentals/concepts/how-cloudflare-works/#how-cloudflare-works-as-a-reverse-proxy), partial (CNAME) setups can be used when you do not want Cloudflare to be [authoritative](#authoritative-dns) for your domain but you still want to proxy individual subdomains through Cloudflare. +Finally, as Cloudflare also works as a [reverse proxy](/fundamentals/concepts/how-cloudflare-works/#how-cloudflare-works-as-a-reverse-proxy), [partial (CNAME) setups](/dns/zone-setups/partial-setup/) can be used when you do not want Cloudflare to be [authoritative](#authoritative-dns) for your domain but you still want to proxy individual subdomains through Cloudflare. ## Zone From f1ad7b0941ce9b148339aca411ec4a8ed1951587 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 5 Dec 2024 13:30:15 +0000 Subject: [PATCH 6/9] Fix typo --- src/content/docs/dns/concepts.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index e284a5be060a7cb..a2a968f1ee64cc3 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -21,7 +21,7 @@ Before you can start using the Cloudflare DNS service, you must first have a dom Very often the same company that offers domain registration also offers web hosting and DNS management. -You can register a domain name at coast through [Cloudflare Registrar](/registrar/). Every domain acquired through Cloudflare Registrar must also use Cloudflare as [primary authoritative DNS](#authoritative-dns). +You can register a domain name at cost through [Cloudflare Registrar](/registrar/). Every domain acquired through Cloudflare Registrar must also use Cloudflare as [primary authoritative DNS](#authoritative-dns). ## Nameserver From 9c6cdcf042f70433a1b01ebd335bdd40fd43dd9a Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 5 Dec 2024 17:28:13 +0000 Subject: [PATCH 7/9] Update zone-setups page title to align with concepts and Dash --- src/content/docs/dns/zone-setups/index.mdx | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/src/content/docs/dns/zone-setups/index.mdx b/src/content/docs/dns/zone-setups/index.mdx index a90b0892e3c2842..d57f9fd1777ab75 100644 --- a/src/content/docs/dns/zone-setups/index.mdx +++ b/src/content/docs/dns/zone-setups/index.mdx @@ -1,9 +1,8 @@ --- pcx_content_type: concept -title: Zone setups +title: DNS setups sidebar: order: 3 - --- import { Details } from "~/components" @@ -40,7 +39,7 @@ If you are on a Free or Pro plan, [full setup](/dns/zone-setups/full-setup/) is If you are on a Business or Enterprise plan, you can use [partial (CNAME) setup](/dns/zone-setups/partial-setup/) to keep your primary DNS provider and only proxy individual subdomains through Cloudflare. -If you are on an Enterprise plan, you also have the option to use [zone transfers](/dns/zone-setups/zone-transfers/) to set up Cloudflare as either a primary or a secondary DNS provider. +If you are on an Enterprise plan, you also have the option to use [zone transfers](/dns/zone-setups/zone-transfers/) to set up Cloudflare as either a primary or a secondary DNS provider. From 182968eca837a7ec0fff443ed7be0bbae76a5194 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Fri, 6 Dec 2024 09:44:59 +0000 Subject: [PATCH 8/9] Link out to domain-configurations as per Abby suggestion --- src/content/docs/dns/concepts.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index a2a968f1ee64cc3..96604c26a0b4d08 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -47,10 +47,12 @@ Finally, as Cloudflare also works as a [reverse proxy](/fundamentals/concepts/ho ## Zone -DNS zone is an administrative concept used for delegating control over DNS settings for different domains. You can read more about this in the [specific Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). +DNS zone is an administrative concept used for delegating control over a given domain and its subdomains. You can read more about this in the [specific Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). For the purpose of this documentation, keep in mind that each domain added to a Cloudflare account is listed in the account home page as a zone. The exact properties and behaviors of your zone depend on its [DNS setup](/dns/zone-setups/). +Also, different Cloudflare products and features are configurable at the zone level. Refer to [Fundamentals](/fundamentals/setup/manage-domains/connect-your-domain/#domain-configurations) for details. + ## DNS records DNS records are instructions that live in the authoritative DNS servers and provide information about a zone. This includes what IP address is associated with a particular domain, but can also cover many other use cases, such as directing emails to a mail server or validating ownership of a domain. From 46c2b99c4584271175f31fa28641b56aa5551908 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 12 Dec 2024 19:25:38 +0000 Subject: [PATCH 9/9] Process suggestions from PCX review --- src/content/docs/dns/concepts.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/content/docs/dns/concepts.mdx b/src/content/docs/dns/concepts.mdx index 96604c26a0b4d08..1cf0ac7b4d079b9 100644 --- a/src/content/docs/dns/concepts.mdx +++ b/src/content/docs/dns/concepts.mdx @@ -9,11 +9,11 @@ head: --- -This page defines and articulates key concepts that are relevant to the Cloudflare DNS service and are used in this documentation. For more concepts and broader descriptions, consider the [Cloudflare Learning Center](https://www.cloudflare.com/learning/dns/what-is-dns/). +This page defines and articulates key concepts that are relevant to the Cloudflare DNS service and are used in this documentation. For more concepts and broader descriptions, refer to the [Cloudflare Learning Center](https://www.cloudflare.com/learning/dns/what-is-dns/). ## Domain -Also known as domain name, a domain is the string of text that identifies a specific website, such as `google.com` or `facebook.com`. Every time you access a website from your web browser, a DNS query takes place and the domain name is mapped to the actual IP address where the website is [hosted](/fundamentals/setup/manage-domains/). +Also known as domain name, a domain is the string of text that identifies a specific website, such as `google.com` or `facebook.com`. Every time you access a website from your web browser, a DNS query takes place and the DNS service maps the domain to the actual IP address where the website is [hosted](/fundamentals/setup/manage-domains/). ## Registrar @@ -21,7 +21,7 @@ Before you can start using the Cloudflare DNS service, you must first have a dom Very often the same company that offers domain registration also offers web hosting and DNS management. -You can register a domain name at cost through [Cloudflare Registrar](/registrar/). Every domain acquired through Cloudflare Registrar must also use Cloudflare as [primary authoritative DNS](#authoritative-dns). +You can register a domain name at cost through [Cloudflare Registrar](/registrar/). Every domain acquired through Cloudflare Registrar must also use Cloudflare as their [primary authoritative DNS](#authoritative-dns). ## Nameserver @@ -47,7 +47,7 @@ Finally, as Cloudflare also works as a [reverse proxy](/fundamentals/concepts/ho ## Zone -DNS zone is an administrative concept used for delegating control over a given domain and its subdomains. You can read more about this in the [specific Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). +DNS zone is an administrative concept used for delegating control over a given domain and its subdomains. Read more in the ["What is a DNS zone?" Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/). For the purpose of this documentation, keep in mind that each domain added to a Cloudflare account is listed in the account home page as a zone. The exact properties and behaviors of your zone depend on its [DNS setup](/dns/zone-setups/).