From 762520c6b3d11347d14b6ef74df27663ed74ece5 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Mon, 25 Nov 2024 11:31:02 +0000 Subject: [PATCH 1/3] Remove broken anchor --- .../docs/dns/zone-setups/subdomain-setup/setup/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx b/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx index 33b220f4f39cfa7..10114b4e8edd675 100644 --- a/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx +++ b/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx @@ -50,7 +50,7 @@ The availability of different setups will depend on both the parent zone setup a :::caution[* Subdomain zones in partial setup are not delegated] -Subdomains using a partial setup represent an exception in the sense that [delegation](#subdomain-delegation) does not apply in this context. As explained in the dedicated [Partial (CNAME) setup section](/dns/zone-setups/partial-setup/), this setup is intended to simply proxy individual subdomains through Cloudflare. For completeness, however, this is listed as an option in this table and the [how-to guide](/dns/zone-setups/subdomain-setup/setup/parent-on-partial/) has detailed explanation on how to achieve a subdomain zone using partial setup. +Subdomains using a partial setup represent an exception in the sense that delegation does not apply in this context. As explained in the dedicated [Partial (CNAME) setup section](/dns/zone-setups/partial-setup/), this setup is intended to simply proxy individual subdomains through Cloudflare. For completeness, however, this is listed as an option in this table and the [how-to guide](/dns/zone-setups/subdomain-setup/setup/parent-on-partial/) has detailed explanation on how to achieve a subdomain zone using partial setup. ::: This table assumes zones that are in an [active status](/dns/zone-setups/reference/domain-status/). For example, if you need to add the parent zone to Cloudflare when its child zone already exists in a partial setup, you can [convert the parent zone to partial](/dns/zone-setups/partial-setup/setup/#1-convert-your-zone-and-review-dns-records) while it is still in pending status. From 26dbbe9463f0ebfa978b8fe75286466cded74bea Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Mon, 25 Nov 2024 11:36:57 +0000 Subject: [PATCH 2/3] Clean up /inline-errata/ from EDNS RFC links --- src/content/docs/dns/dns-firewall/faq.mdx | 2 +- src/content/glossary/dns.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/dns/dns-firewall/faq.mdx b/src/content/docs/dns/dns-firewall/faq.mdx index 08cfb68e36feb14..8239ed49d3d9436 100644 --- a/src/content/docs/dns/dns-firewall/faq.mdx +++ b/src/content/docs/dns/dns-firewall/faq.mdx @@ -32,7 +32,7 @@ Yes. `SERVFAIL` is treated like any other negative answer for caching purposes.
-Yes. Often, DNS providers want to see a client's IP via EDNS Client Subnet (ECS) ([RFC 7871](https://www.rfc-editor.org/rfc/inline-errata/rfc7871.html)) because they serve geographically specific DNS answers based on the client's IP. With EDNS Client Subnet enabled, the DNS Firewall will forward the client's IP subnet along with the DNS query to the upstream nameserver. +Yes. Often, DNS providers want to see a client's IP via EDNS Client Subnet (ECS) ([RFC 7871](https://www.rfc-editor.org/rfc/rfc7871.html)) because they serve geographically specific DNS answers based on the client's IP. With EDNS Client Subnet enabled, the DNS Firewall will forward the client's IP subnet along with the DNS query to the upstream nameserver. When EDNS is enabled, the DNS Firewall gives out the geographically correct answer in cache based on the client IP subnet. To do this, the DNS Firewall segments its cache. For example: diff --git a/src/content/glossary/dns.yaml b/src/content/glossary/dns.yaml index 4bf4484fe5eeb4c..dea66cfc8d159ff 100644 --- a/src/content/glossary/dns.yaml +++ b/src/content/glossary/dns.yaml @@ -47,7 +47,7 @@ entries: general_definition: |- ECS is a DNS extension that enables recursive DNS resolvers to include client IP address information in their DNS queries. - Not all resolvers use ECS but, if they do, usually a part of the IP address is omitted. Sending ECS headers is generally intended to reduce latency and speed up content delivery in connection to [CDNs](/glossary/?term=cdn) and [load balancers](https://www.cloudflare.com/learning/performance/what-is-load-balancing/). The ECS mechanism is specified in [RFC 7871](https://www.rfc-editor.org/rfc/inline-errata/rfc7871.html). + Not all resolvers use ECS but, if they do, usually a part of the IP address is omitted. Sending ECS headers is generally intended to reduce latency and speed up content delivery in connection to [CDNs](/glossary/?term=cdn) and [load balancers](https://www.cloudflare.com/learning/performance/what-is-load-balancing/). The ECS mechanism is specified in [RFC 7871](https://www.rfc-editor.org/rfc/rfc7871.html). associated_products: - Load Balancing - Cloudflare One From df7e6a99f1c60d18e35a47f39369cf3f88e6e678 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Mon, 25 Nov 2024 11:45:07 +0000 Subject: [PATCH 3/3] Update Style Guide with note about not using inline-errata RFC --- .../docs/style-guide/formatting/external-references.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/style-guide/formatting/external-references.mdx b/src/content/docs/style-guide/formatting/external-references.mdx index 6f9c4f870058217..50a02545a117b55 100644 --- a/src/content/docs/style-guide/formatting/external-references.mdx +++ b/src/content/docs/style-guide/formatting/external-references.mdx @@ -13,7 +13,7 @@ For general websites, consider the following recommendations about the link text * Authoritative sources for documents such as RFCs can have their own specific format for references, such as the RFC number. :::note -When linking to a Cloudflare blog post, sometimes we use only "blog post" for the link text. +When linking to a Cloudflare blog post, sometimes we use only "blog post" for the link text. ::: ## Referencing RFCs @@ -37,8 +37,8 @@ When linking to an RFC (or RFC section), consider using a link to the following To get the link: 1. Go to [RFC Editor](https://www.rfc-editor.org/rfc-index.html) and search for the RFC number. -2. Select HTML to open the HTML version. -3. (optional) Navigate to a specific section, if necessary. +2. Select **HTML** to open the HTML version. If available, do **not** use **HTML with inline errata** as this version should not be used as reference. +3. (Optional) Go to a specific section, if necessary. 4. Use the current URL as the link target in Developer Documentation. URL example: