From 6516ec97dea96279ed6894e8375b6d33bbf63aa0 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 21 Nov 2024 08:27:05 +0000 Subject: [PATCH 1/5] Add background info paragraph and link out for more --- src/content/docs/dns/manage-dns-records/index.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/content/docs/dns/manage-dns-records/index.mdx b/src/content/docs/dns/manage-dns-records/index.mdx index b827de62b345b9c..3ad7772bf4988f4 100644 --- a/src/content/docs/dns/manage-dns-records/index.mdx +++ b/src/content/docs/dns/manage-dns-records/index.mdx @@ -10,6 +10,8 @@ import { DirectoryListing, FeatureTable, GlossaryTooltip } from "~/components" DNS records contain information about your domain and are used to make your website or application available to visitors and other web services. +Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. As an [authoritative DNS provider](/fundamentals/concepts/how-cloudflare-works/#how-cloudflare-works-as-a-dns-provider), Cloudflare can help you manage your DNS records. + For background about different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). ## DNS records quota From 1ddae5492d7b7f7dae9440aa01e42b036cea4380 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 21 Nov 2024 08:51:58 +0000 Subject: [PATCH 2/5] Introduce DNS records table, as well as proxy status and flattening --- src/content/docs/dns/manage-dns-records/index.mdx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/src/content/docs/dns/manage-dns-records/index.mdx b/src/content/docs/dns/manage-dns-records/index.mdx index 3ad7772bf4988f4..2c928cec75b5981 100644 --- a/src/content/docs/dns/manage-dns-records/index.mdx +++ b/src/content/docs/dns/manage-dns-records/index.mdx @@ -10,9 +10,13 @@ import { DirectoryListing, FeatureTable, GlossaryTooltip } from "~/components" DNS records contain information about your domain and are used to make your website or application available to visitors and other web services. -Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. As an [authoritative DNS provider](/fundamentals/concepts/how-cloudflare-works/#how-cloudflare-works-as-a-dns-provider), Cloudflare can help you manage your DNS records. +Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. As an authoritative DNS provider, Cloudflare can help you manage your DNS records. -For background about different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). +## DNS records table + +DNS records have different types and each type serve a different purpose. For background about the different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). To quickly find reference information about a specific type refer to [DNS record types](/dns/manage-dns-records/reference/dns-record-types/). + +When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](dns/cname-flattening/). These are specific features offered by Cloudflare. ## DNS records quota From bd207582ed591f1095ff4950fdcf279f2bb78d0f Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 21 Nov 2024 09:55:08 +0000 Subject: [PATCH 3/5] Fill in common field descriptions and add an example with explanantion --- .../docs/dns/manage-dns-records/index.mdx | 27 +++++++++++++++++-- 1 file changed, 25 insertions(+), 2 deletions(-) diff --git a/src/content/docs/dns/manage-dns-records/index.mdx b/src/content/docs/dns/manage-dns-records/index.mdx index 2c928cec75b5981..39ecc86ef2fb90b 100644 --- a/src/content/docs/dns/manage-dns-records/index.mdx +++ b/src/content/docs/dns/manage-dns-records/index.mdx @@ -6,11 +6,11 @@ sidebar: --- -import { DirectoryListing, FeatureTable, GlossaryTooltip } from "~/components" +import { DirectoryListing, FeatureTable, GlossaryTooltip, Details, Example } from "~/components" DNS records contain information about your domain and are used to make your website or application available to visitors and other web services. -Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. As an authoritative DNS provider, Cloudflare can help you manage your DNS records. +Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. According to your [setup](/dns/zone-setups/), you can use Cloudflare to manage your DNS records. ## DNS records table @@ -18,6 +18,29 @@ DNS records have different types and each type serve a different purpose. For ba When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](dns/cname-flattening/). These are specific features offered by Cloudflare. +
+- **Type**: Defines the purpose of a record. Different types of record require different information in their corresponding `Content` field. +- **Name**: Identifies the resource that the record resolves to. Depending on the purpose of the record, the value you want to add to this field will also change. +- **Content**: Contains the core value of a record, depending on the record type. +- **TTL**: Controls how long each record is cached by DNS resolvers. +
+ +
+ + +DNS management for **example.com**: + +| Type | Name | Content | Proxy status | TTL | +| ---- | ------- | ------------ | ------------ | ------ | +| A | `blog` | `192.0.2.1` | Proxied | Auto | + +In this example, an IP address resolution record of type `A` is indicating that the resources that correspond to the subdomain `blog.example.com` can be reached on the IPv4 address `192.0.2.1`. + +Also, as this record is proxied, Cloudflare automatically defines for how long this information should be cached by DNS resolvers. + + +
+ ## DNS records quota There is a limit to the number of records you can create on a single zone. From 3b8300e543441e73666b0ce910f541bf85f3a2d0 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 21 Nov 2024 10:04:19 +0000 Subject: [PATCH 4/5] Fix broken link --- src/content/docs/dns/manage-dns-records/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/dns/manage-dns-records/index.mdx b/src/content/docs/dns/manage-dns-records/index.mdx index 39ecc86ef2fb90b..a8cce2dd9456978 100644 --- a/src/content/docs/dns/manage-dns-records/index.mdx +++ b/src/content/docs/dns/manage-dns-records/index.mdx @@ -16,7 +16,7 @@ Depending on the providers you used to [get your domain name](/fundamentals/setu DNS records have different types and each type serve a different purpose. For background about the different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). To quickly find reference information about a specific type refer to [DNS record types](/dns/manage-dns-records/reference/dns-record-types/). -When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](dns/cname-flattening/). These are specific features offered by Cloudflare. +When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](/dns/cname-flattening/). These are specific features offered by Cloudflare.
- **Type**: Defines the purpose of a record. Different types of record require different information in their corresponding `Content` field. From 176407591921c161a54160ca4fa6aaa878955a49 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 21 Nov 2024 10:14:36 +0000 Subject: [PATCH 5/5] Text review and adjust setup link to a more introductory page --- src/content/docs/dns/manage-dns-records/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/dns/manage-dns-records/index.mdx b/src/content/docs/dns/manage-dns-records/index.mdx index a8cce2dd9456978..0c79d1edffa1997 100644 --- a/src/content/docs/dns/manage-dns-records/index.mdx +++ b/src/content/docs/dns/manage-dns-records/index.mdx @@ -10,11 +10,11 @@ import { DirectoryListing, FeatureTable, GlossaryTooltip, Details, Example } fro DNS records contain information about your domain and are used to make your website or application available to visitors and other web services. -Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. According to your [setup](/dns/zone-setups/), you can use Cloudflare to manage your DNS records. +Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. According to your [setup](/dns/get-started/), you can use Cloudflare to manage your DNS records. ## DNS records table -DNS records have different types and each type serve a different purpose. For background about the different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). To quickly find reference information about a specific type refer to [DNS record types](/dns/manage-dns-records/reference/dns-record-types/). +DNS records have different types and each type serves a different purpose. For background about the different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). To quickly find reference information about a specific type refer to [DNS record types](/dns/manage-dns-records/reference/dns-record-types/). When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](/dns/cname-flattening/). These are specific features offered by Cloudflare.