[iDNS] Internal DNS MVP UI release #22632

RebeccaTamachiro · 2025-05-23T13:02:50Z

Summary

PCX-17295

hyperlint-ai · 2025-05-23T13:03:17Z

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

Released the MVP UI for Internal DNS, enhancing user guidance and API integration.

Added dashboard and API instructions for creating and deleting DNS views.
Introduced tabs for better navigation between dashboard and API instructions.
Updated internal zone setup instructions with dashboard and API options.

Modified Files

src/content/docs/dns/internal-dns/dns-views.mdx
src/content/docs/dns/internal-dns/get-started.mdx
src/content/docs/dns/internal-dns/internal-zones/reference-zones.mdx
src/content/docs/dns/internal-dns/internal-zones/setup.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.

github-actions · 2025-05-23T13:03:58Z

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

Pattern	Owners
`/src/content/docs/dns/`	`@RebeccaTamachiro`, `@cloudflare/pcx-technical-writing`
`*`	`@cloudflare/pcx-technical-writing`

github-actions · 2025-05-23T13:12:31Z

Preview URL: https://e60d3b56.preview.developers.cloudflare.com
Preview Branch URL: https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/dns/internal-dns/get-started/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/internal-dns/get-started/
https://developers.cloudflare.com/dns/internal-dns/dns-views/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/internal-dns/dns-views/
https://developers.cloudflare.com/dns/internal-dns/internal-zones/reference-zones/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/reference-zones/
https://developers.cloudflare.com/dns/internal-dns/internal-zones/setup/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/setup/
https://developers.cloudflare.com/dns/internal-dns/internal-zones/internal-dns-records/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/internal-dns-records/
https://developers.cloudflare.com/dns/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/
https://developers.cloudflare.com/dns/internal-dns/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/internal-dns/
https://developers.cloudflare.com/dns/internal-dns/internal-zones/	https://rebecca-idns-mvp-ui-release.preview.developers.cloudflare.com/dns/internal-dns/internal-zones/

src/content/docs/dns/internal-dns/dns-views.mdx

src/content/partials/dns/internal-zone-create-dash.mdx

windsurf-bot

Other comments (3)

src/content/docs/dns/internal-dns/get-started.mdx (18-18) Consider re-adding a reference to [API Fundamentals](/fundamentals/api/get-started/) for users who may need help with the API steps.
src/content/docs/dns/internal-dns/internal-zones/reference-zones.mdx (43-43) Remove the space in the closing `` tag to use the correct `` syntax.
src/content/docs/dns/index.mdx (20-20) Typo: 'Intenal DNS (Beta)' should be 'Internal DNS (Beta)'.

💡 To request another review, post a new comment with "/windsurf-review".

windsurf-bot · 2025-06-04T11:14:06Z

src/content/docs/dns/internal-dns/get-started.mdx

+<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
+
+<Render file="internal-zone-create-dash" params={{
+	conditional: "get-started-detail"}}
+/>
+
+</TabItem> <TabItem label="API">
+
+<Render file="internal-zone-create-api" params={{
 	conditional: "get-started-detail"}}
 />

+</TabItem> </Tabs>
+
 ### (Optional) Reference a zone from another zone

-1. Use the [Update DNS settings](/api/resources/dns/subresources/settings/subresources/zone/methods/edit/) endpoint to add a reference from an internal zone to another internal zone. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`. For details, refer to [reference zones](/dns/internal-dns/internal-zones/reference-zones/).
+<Render file="internal-reference-zone-intro" params={{
+	conditional: "get-started-link"}}
+/>
+
+<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
+
+1. Go to **Internal DNS** and select a zone.
+2. Within the selected zone, go to **Reference zone**.
+3. Select **Add reference zone**.
+4. Find the zone you want to use as reference and choose **Select** in the respective row.
+
+</TabItem> <TabItem label="API">
+
+1. Use the [Update DNS settings](/api/resources/dns/subresources/settings/subresources/zone/methods/edit/) endpoint to add a reference from an internal zone to another internal zone. In `--json`, specify the `internal_dns` object with the parameter `reference_zone_id`.

 <Example>
 <Render file="internal-reference-zone-api"/>
 </ Example>

+</TabItem> </Tabs>
+
 ## 2. Link your internal zone to a view

 Since the resolver policy will require a [DNS view](/dns/internal-dns/dns-views/), you must have at least one view to be able to route requests to internal zones.

+<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
+
+<Render file="internal-dns-view-create-dash" params={{
+	conditional: "get-started-detail"}}
+/>
+
+</TabItem> <TabItem label="API">
+
 1. Use the [Create Internal DNS View](/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/create/) endpoint. For each view you create, list all the internal zones that should be grouped under that view.

 <Details header="DNS view configuration conditions">
 <Render file="internal-dns-view-conditions" />
 </Details>

+</TabItem> </Tabs>


If these tab groups are meant to be independent, assign a unique syncKey to each Tabs component to avoid synchronized tab switching across unrelated sections.

windsurf-bot · 2025-06-04T11:14:06Z

src/content/docs/dns/internal-dns/internal-zones/reference-zones.mdx


 :::note
-A wildcard record (`*.example.local`) in the matching internal zone will take precedence over an exact match in a referenced zone.
+A wildcard record (`*.example.local`) in the matching internal zone will take precedence over an exact match in a reference zone.


Consider standardizing the use of 'reference zone' vs 'referenced zone' throughout the document for consistency and clarity.

windsurf-bot · 2025-06-04T11:14:06Z

src/content/docs/dns/internal-dns/index.mdx

 <Plan type="enterprise" />

-Manage DNS records that should only be accessible within your private network. Internal DNS [zones](/dns/internal-dns/internal-zones/) and [views](/dns/internal-dns/dns-views/) pair up with [Gateway resolver policies](/cloudflare-one/policies/gateway/resolver-policies/) so that you can control how a DNS query should be responded to according to the query context, such as its source IP.
+Manage DNS records that should only be accessible within your private network. Internal DNS [zones](/dns/internal-dns/internal-zones/) and [views](/dns/internal-dns/dns-views/) pair up with [Gateway resolver policies](/cloudflare-one/policies/gateway/resolver-policies/) so that you can control how a DNS query should be responded to according to query context, such as query source IP.


The revised sentence removes 'the' and 'its', making the sentence less clear. Consider reverting to: 'according to the query context, such as its source IP.' for improved readability.

src/content/docs/dns/index.mdx

src/content/docs/dns/internal-dns/dns-views.mdx

src/content/docs/dns/internal-dns/get-started.mdx

src/content/docs/dns/internal-dns/internal-zones/reference-zones.mdx

src/content/partials/dns/internal-dns-view-create-dash.mdx

src/content/partials/dns/internal-zone-create-dash.mdx

Co-authored-by: Maddy <[email protected]>

* Add Dash steps for internal zone creation * Add tabs components and Dash steps to dns-views * Revise create a view Dash steps * Add dash instructions for reference zone assignment * Get-started: remove api-only and add Dash tab placeholder * Fix broken link * Add partial for zone creation and replace in relevant pages * Add reference zone dash steps and intro to get-started * Create and apply partial for view-create-dash * Overall review and add conditions to view creation partial * Overall review and link to iDNS from docs landing page * Specify reference at the bottom of internal zones and view is API-only * Add Internal DNS to /products page * Remove 'descriptive' specification for zone name * Update get-started to match Gateway resolver UI text * Fix typo * Apply suggestions from code review Co-authored-by: Maddy <[email protected]> * Add missing period and implement some page descriptions --------- Co-authored-by: Maddy <[email protected]>

RebeccaTamachiro added 5 commits May 21, 2025 16:25

Add Dash steps for internal zone creation

2184893

Add tabs components and Dash steps to dns-views

4ed1fe6

Revise create a view Dash steps

d41b450

Add dash instructions for reference zone assignment

fb0724b

Get-started: remove api-only and add Dash tab placeholder

3bb666b

github-actions bot added product:dns Issues or PRs related to DNS size/s labels May 23, 2025

RebeccaTamachiro added 2 commits May 23, 2025 14:58

Fix broken link

2ca66fd

Add partial for zone creation and replace in relevant pages

cb3afe2

github-actions bot added size/m and removed size/s labels May 26, 2025

RebeccaTamachiro added 3 commits May 26, 2025 16:43

Add reference zone dash steps and intro to get-started

aa561fb

Create and apply partial for view-create-dash

3ddc1ba

Overall review and add conditions to view creation partial

6aaaf90

Randy88-art reviewed May 26, 2025

View reviewed changes

src/content/docs/dns/internal-dns/dns-views.mdx

This comment was marked as off-topic.

Sign in to view

RebeccaTamachiro added 3 commits May 27, 2025 09:51

Overall review and link to iDNS from docs landing page

49b728d

Specify reference at the bottom of internal zones and view is API-only

4364cd0

Add Internal DNS to /products page

b0fd936

hannes-cf reviewed Jun 4, 2025

View reviewed changes

src/content/partials/dns/internal-zone-create-dash.mdx Outdated Show resolved Hide resolved

RebeccaTamachiro added 2 commits June 4, 2025 11:15

Remove 'descriptive' specification for zone name

cc353db

Update get-started to match Gateway resolver UI text

5e036fb

RebeccaTamachiro marked this pull request as ready for review June 4, 2025 11:13

RebeccaTamachiro requested a review from a team as a code owner June 4, 2025 11:13

windsurf-bot bot reviewed Jun 4, 2025

View reviewed changes

Fix typo

023b209

Maddy-Cloudflare approved these changes Jun 4, 2025

View reviewed changes

RebeccaTamachiro added the do-not-merge-yet label Jun 5, 2025

RebeccaTamachiro and others added 2 commits June 5, 2025 14:14

Apply suggestions from code review

ba9fd22

Co-authored-by: Maddy <[email protected]>

Add missing period and implement some page descriptions

e60d3b5

RebeccaTamachiro removed the do-not-merge-yet label Jun 6, 2025

RebeccaTamachiro merged commit 58f5465 into production Jun 6, 2025
11 checks passed

RebeccaTamachiro deleted the rebecca/idns-mvp-ui-release branch June 6, 2025 12:18

[iDNS] Internal DNS MVP UI release #22632

[iDNS] Internal DNS MVP UI release #22632

Uh oh!

Conversation

RebeccaTamachiro commented May 23, 2025

Summary

Uh oh!

hyperlint-ai bot commented May 23, 2025

PR Change Summary

Uh oh!

github-actions bot commented May 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented May 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as off-topic.

Uh oh!

Uh oh!

windsurf-bot bot left a comment

Choose a reason for hiding this comment

Uh oh!

windsurf-bot bot Jun 4, 2025

Choose a reason for hiding this comment

Uh oh!

windsurf-bot bot Jun 4, 2025

Choose a reason for hiding this comment

Uh oh!

windsurf-bot bot Jun 4, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions bot commented May 23, 2025 •

edited

Loading

github-actions bot commented May 23, 2025 •

edited

Loading