Skip to content

[Cloudflare One] DNS Policies ELI5#28883

Merged
Oxyjun merged 10 commits intoproductionfrom
cf1/jun/traffic-policies/dns/eli5
Mar 24, 2026
Merged

[Cloudflare One] DNS Policies ELI5#28883
Oxyjun merged 10 commits intoproductionfrom
cf1/jun/traffic-policies/dns/eli5

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented Mar 10, 2026

Improves clarity across the 4 pages in /cloudflare-one/traffic-policies/dns-policies/ by adding inline definitions, spelling out acronyms, and surfacing non-obvious behavior. Generated via ELI5 analysis of all sections.

index.mdx

  • Add a plain-language opening paragraph explaining what DNS policies are and why they matter
  • Link to Gateway overview on first mention
  • Define the three evaluation phases (Before/During/After DNS resolution) that appear in every selector table but were never explained
  • Rewrite the Allow action description to clarify its purpose as an exception mechanism, not a redundant pass-through
  • Fix the grammatically broken Override action description ("respond to all DNS queries for a given domain to another destination" → "replace the real DNS answer with a destination you specify")
  • Add inline DNSSEC definition before the validation toggle
  • Annotate A/AAAA record types with (IPv4)/(IPv6) in the block page section
  • Spell out EDNS, DoH, DoT on first use
  • Clarify the authoritative nameserver selector (remove redundant "IP address of the IP address")
  • Rewrite fallback DNS limitation to explain the bypass mechanism

common-policies.mdx

  • Spell out EAR, OFAC, ITAR acronyms on first use
  • Add EDNS definition in the dynamic categories section
  • Define TLDs inline ("the last segment of a domain name, such as .com or .ru")
  • Replace "egress to the origin server" with "when Gateway connects to the destination server"
  • Annotate Force IPv4/IPv6 with the record types being blocked

test-dns-filtering.mdx

  • Expand prerequisites to distinguish WARP vs DNS-only deployments
  • Define dig and nslookup tools for readers unfamiliar with them
  • Correct "answer section" to "header line" for where REFUSED/NOERROR appear in dig output
  • Add inline definitions for REFUSED and NOERROR DNS response codes
  • Define EDNS client subnet before the EDNS test section
  • Spell out DoH on first use

timed-policies.mdx

  • Add use-case examples to the opening paragraph (work-hours blocking, maintenance windows)
  • Add a :::caution callout for the non-obvious duration timer behavior (absolute end time, not a pausable countdown)
  • Add a :::note callout for VPN/proxy timezone inference pitfall
  • Fix "we will fall back" → "it will fall back" (consistent third-person voice)

Oxyjun added 4 commits March 9, 2026 11:38
…itions and context

Add plain-language introductions, spell out acronyms (DNSSEC, EDNS, DoH, DoT,
EAR, OFAC, ITAR), define evaluation phases for selectors, clarify Allow/Override
action descriptions, expand prerequisites in test page, and add pitfall callouts
for timed policy duration and timezone inference.
@github-actions
Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-one/traffic-policies/ @cloudflare/pcx-technical-writing

Replace /cloudflare-one/policies/gateway/ (does not exist) with
/cloudflare-one/traffic-policies/ (correct Gateway overview page).
Comment thread src/content/docs/cloudflare-one/traffic-policies/dns-policies/index.mdx Outdated
Comment thread src/content/docs/cloudflare-one/traffic-policies/dns-policies/index.mdx Outdated
Comment thread src/content/docs/cloudflare-one/traffic-policies/dns-policies/index.mdx Outdated
Oxyjun added 2 commits March 10, 2026 14:34
- Allow action: qualify with first-match principle and link to order
  of enforcement, instead of oversimplified precedence claim
- Evaluation phases: correct Override restriction to include both
  'during' and 'after' phases (not just 'after'), add link to order
  of enforcement
- Authoritative nameserver: revert inline definition per reviewer
  request (adds clutter)
- EDNS client subnet: clarify /24 is Cloudflare's implementation
  choice, fix 'upstream DNS resolver' to 'authoritative DNS
  nameservers' per RFC 7871
Comment thread src/content/docs/cloudflare-one/traffic-policies/dns-policies/common-policies.mdx Outdated
@Oxyjun Oxyjun changed the title [Cloudflare One] Clarify DNS policies with inline definitions and context [Cloudflare One] DNS Policies ELI5 Mar 11, 2026
@Oxyjun Oxyjun self-assigned this Mar 11, 2026
Comment thread src/content/docs/cloudflare-one/traffic-policies/dns-policies/index.mdx Outdated
Comment thread src/content/docs/cloudflare-one/traffic-policies/dns-policies/common-policies.mdx Outdated
@Oxyjun Oxyjun enabled auto-merge (squash) March 16, 2026 15:39
@Oxyjun Oxyjun merged commit a0610d8 into production Mar 24, 2026
11 checks passed
@Oxyjun Oxyjun deleted the cf1/jun/traffic-policies/dns/eli5 branch March 24, 2026 13:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants