Skip to content

[iDNS] Clarify CNAME flattening and reference zones #20891

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 20 commits into from
Mar 26, 2025
Merged

[iDNS] Clarify CNAME flattening and reference zones #20891

merged 20 commits into from
Mar 26, 2025

Conversation

@RebeccaTamachiro
Copy link
Contributor

@RebeccaTamachiro RebeccaTamachiro commented Mar 17, 2025

Summary

PCX-16198

Documentation checklist

@RebeccaTamachiro
Add conditional rendering for create internal zone
55bd61a
@RebeccaTamachiro
Clear out unused components from internal-zone-create
74b64b4
@RebeccaTamachiro
Fix syntax to make conditional property opitional
03d4606
@RebeccaTamachiro
Add .yaml file so that iDNS comes up in /products
5dff074
@RebeccaTamachiro
Update DNS records link to point to #internal-dns-records
8f82673
@RebeccaTamachiro
Create and apply partial for reference-zone-intro
647e895
@RebeccaTamachiro
Add info about CNAME flatenning to iDNS docs
23d14e9
@RebeccaTamachiro
Add note about wildcard record and reference zones
9fe349b
@RebeccaTamachiro
Revert "Add .yaml file so that iDNS comes up in /products"
938dbf6 
This reverts commit 5dff074.
@RebeccaTamachiro
Create dedicated pages to reference zones and internal records
53bf5dd
@RebeccaTamachiro
Descride CNAME flattening behavior with reference zones and view
6f8f186
@RebeccaTamachiro
Add CNAME flattening example
bff3dee
@RebeccaTamachiro
Re-org and further detail reference zones conditions
8315bcf
@RebeccaTamachiro
Remove redundant reference-zone-intro partial
400de45
@hyperlint-ai
Copy link
Contributor

hyperlint-ai bot commented Mar 17, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.

PR Change Summary

Clarified CNAME flattening and improved references to internal DNS zones in the documentation.

  • Enhanced explanations of CNAME flattening and its application to zone apex.
  • Updated internal DNS documentation to include new sections on managing internal DNS records and reference zones.
  • Improved links and references throughout the internal DNS documentation for better clarity.

Modified Files

  • src/content/docs/dns/cname-flattening/index.mdx
  • src/content/docs/dns/internal-dns/get-started.mdx
  • src/content/docs/dns/internal-dns/index.mdx
  • src/content/docs/dns/internal-dns/internal-zones/index.mdx
  • src/content/docs/dns/internal-dns/internal-zones/reference-zones.mdx
  • src/content/docs/dns/internal-dns/internal-zones/setup.mdx

Added Files

  • src/content/docs/dns/internal-dns/internal-zones/internal-dns-records.mdx
  • src/content/partials/dns/internal-zone-create.mdx
How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

What is Hyperlint?

Hyperlint is an AI agent that helps you write, edit, and maintain your documentation.

Learn more about the Hyperlint AI reviewer and the checks that we can run on your documentation.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 17, 2025 •
edited
Loading

Preview URL: https://814d7edf.preview.developers.cloudflare.com
Preview Branch URL: https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/dns/internal-dns/internal-zones/internal-dns-records/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/internal-dns-records/
https://developers.cloudflare.com/dns/internal-dns/internal-zones/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/
https://developers.cloudflare.com/dns/internal-dns/internal-zones/reference-zones/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/reference-zones/
https://developers.cloudflare.com/dns/cname-flattening/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/cname-flattening/
https://developers.cloudflare.com/dns/internal-dns/dns-views/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/internal-dns/dns-views/
https://developers.cloudflare.com/dns/internal-dns/get-started/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/internal-dns/get-started/
https://developers.cloudflare.com/dns/internal-dns/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/internal-dns/
https://developers.cloudflare.com/dns/internal-dns/internal-zones/setup/ https://rebecca-idns-clarify-cname-reference-zones.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/setup/

@github-actions github-actions bot added the product:dns Issues or PRs related to DNS label Mar 17, 2025
@RebeccaTamachiro RebeccaTamachiro marked this pull request as ready for review March 26, 2025 11:18
@RebeccaTamachiro RebeccaTamachiro requested a review from a team as a code owner March 26, 2025 11:18
@RebeccaTamachiro RebeccaTamachiro enabled auto-merge (squash) March 26, 2025 12:58
@RebeccaTamachiro RebeccaTamachiro merged commit 4450392 into production Mar 26, 2025
11 checks passed
@RebeccaTamachiro RebeccaTamachiro deleted the rebecca/idns-clarify-cname-reference-zones branch March 26, 2025 13:08
RebeccaTamachiro added a commit that referenced this pull request Apr 21, 2025
@RebeccaTamachiro
[iDNS] Clarify CNAME flattening and reference zones (#20891)
cabdb71 
* Add conditional rendering for create internal zone

* Clear out unused components from internal-zone-create

* Fix syntax to make conditional property opitional

* Add .yaml file so that iDNS comes up in /products

* Update DNS records link to point to #internal-dns-records

* Create and apply partial for reference-zone-intro

* Add info about CNAME flatenning to iDNS docs

* Add note about wildcard record and reference zones

* Revert "Add .yaml file so that iDNS comes up in /products"

This reverts commit 5dff074.

* Create dedicated pages to reference zones and internal records

* Descride CNAME flattening behavior with reference zones and view

* Add CNAME flattening example

* Re-org and further detail reference zones conditions

* Remove redundant reference-zone-intro partial

* Fix link to get-started and more specific CNAME h2

* Add quotes to labels to fix mermaid diagram

* More generic CNAME flattening explanation and adjust example

* Link to more context around Gateway resolver in iDNS
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@marciocloudflare marciocloudflare marciocloudflare approved these changes

Assignees

No one assigned

Labels

product:dns Issues or PRs related to DNS size/m

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@RebeccaTamachiro @marciocloudflare