Merge pull request #259681 from greg-lindsay/dns-freshness

editing subdomain article

Author: PMEds28

articles/dns/delegate-subdomain.md

@@ -5,72 +5,67 @@ services: dns
 author: greg-lindsay
 ms.service: dns
 ms.topic: how-to
-ms.date: 09/27/2022
+ms.date: 11/28/2023
 ms.author: greglin
 ---
 
 # Delegate an Azure DNS subdomain
 
-You can use the Azure portal to delegate a DNS subdomain. For example, if you own the contoso.com domain, you may delegate a subdomain called *engineering* to another separate zone that you can administer separately from the contoso.com zone.
+You can use the Azure portal to delegate a DNS subdomain. For example, if you own the *adatum.com* domain, you can delegate a subdomain called *engineering.adatum.com* to another separate zone that you can administer separately from the adatum.com zone.
 
-If you prefer, you can also delegate a subdomain using [Azure PowerShell](delegate-subdomain-ps.md).
+You can also delegate a subdomain using [Azure PowerShell](delegate-subdomain-ps.md).
 
 ## Prerequisites
 
-To delegate an Azure DNS subdomain, you must first delegate your public domain to Azure DNS. See [Delegate a domain to Azure DNS](./dns-delegate-domain-azure-dns.md) for instructions on how to configure your name servers for delegation. Once your domain is delegated to your Azure DNS zone, you can delegate your subdomain.
+To delegate an Azure DNS subdomain, the parent public domain must first be delegated to Azure DNS. See [Delegate a domain to Azure DNS](./dns-delegate-domain-azure-dns.md) for instructions on how to configure your name servers for delegation. Once your domain is delegated to Azure DNS, you can delegate a subdomain.
 
 > [!NOTE]
-> Contoso.com is used as an example throughout this article. Substitute your own domain name for contoso.com.
+> The `adatum.com` zone is used as an example of a parent DNS zone and `engineering.adatum.com` is used for the subdomain. Substitute your own domain names for these domains.
 
-## Create a zone for your subdomain
+## Delegate a subdomain
 
-First, create the zone for the **engineering** subdomain.
+The **engineering.adatum.com** subdomain can already exist. If it doesn't exist, it is created.
 
-1. From the Azure portal, select **+ Create a resource**.
+To delegate the **engineering** subdomain under **adatum.com**:
 
-1. Search for **DNS zone** and then select **Create**.
+1. From the Azure portal, search for **DNS zones** and select the **adatum.com** parent zone.
+2. Select **+ Child zone** and enter **engineering** next to **Name**. The **Create DNS zone** window opens.
 
-1. On the **Create DNS zone** page, select the resource group for your zone. You may want to use the same resource group as the parent zone to keep similar resources together.
+   ![A screenshot showing creation of a child DNS zone.](./media/delegate-subdomain/new-child-zone.png)
 
-1.  Enter `engineering.contoso.com` for the **Name** and then select **Create**.
+3. If desired, change the **Subscription** and **Resource group**. In this example, we use the same subscription and resource group as the parent zone.
+4. Select **Review create**, and then select **Create**.
+5. When deployment is complete, select **Go to resource** to view the new delegated zone: **engineering.adatum.com**.
 
-1. After the deployment succeeds, go to the new zone.
+   [ ![A screenshot showing contents of the child zone.](./media/delegate-subdomain/child-zone-contents.png) ](./media/delegate-subdomain/child-zone-contents.png#lightbox)
 
-## Note the name servers
+6. Select the parent **adatum.com** zone again and notice that an **NS** record has been added with the name **engineering** and contents the same as NS records in the child zone. You might need to refresh the page. These are the Azure DNS nameservers that are authoritative for the subdomain (child zone).
 
-Next, note the four name servers for the engineering subdomain.
+   [ ![A screenshot showing contents of the parent zone.](./media/delegate-subdomain/parent-zone-contents.png) ](./media/delegate-subdomain/parent-zone-contents.png#lightbox)
 
-On the **engineering** zone overview page, note the four name servers for the zone. You'll need these name servers at a later time.
+## Manual entry of NS records (optional)
 
-## Create a test record
-
-Create an **A** record to use for testing. For example, create a **www** A record and configure it with a **10.10.10.10** IP address.
-
-## Create an NS record
-
-Next, create a name server (NS) record  for the **engineering** zone.
+If desired, you can also create your subdomain and add the subdomain NS record manually.
 
-1. Navigate to the zone for the parent domain.
+To create a new subdomain zone, use **Create a resource > DNS zone** and create a zone named **engineering.adatum.com**.
 
-1. Select **+ Record set** at the top of the overview page.
+To create a subdomain delegation manually, add a new NS record set (**+ Record set** option) to the parent zone **adatum.com** with the name: **engineering** and specify each of the nameserver entries that are listed in the subdomain (child) zone.
 
-1. On the **Add record set** page, type **engineering** in the **Name** text box.
+<br><img src="./media/delegate-subdomain/add-ns-record-set.png" alt="A screenshot showing how to add an NS record set." width="50%">
 
-1. For **Type**, select **NS**.
+This method doesn't use the **+ Child zone** option, but both methods result in the same delegation.
 
-1. Under **Name server**, enter the four name servers that you noted previously from the **engineering** zone.
+## Create a test record
 
-1. Select **OK** to save the record.
+Next, create an **A** record in the **engineering.adatum.com** zone to use for testing. For example, create a **www** A record and configure it with a **10.10.10.10** IP address.
 
 ## Test the delegation
 
 Use nslookup to test the delegation.
 
-1. Open a PowerShell window.
-
-1. At command prompt, type `nslookup www.engineering.contoso.com.`
-
-1. You should receive a non-authoritative answer showing the address **10.10.10.10**.
+1. Open a command prompt.
+2. At command prompt, type `nslookup www.engineering.adatum.com.`
+3. You should receive a non-authoritative answer showing the address **10.10.10.10**.
 
 ## Next steps
 

articles/dns/dns-operations-recordsets-portal.md

@@ -5,7 +5,7 @@ services: dns
 author: greg-lindsay
 ms.service: dns
 ms.topic: how-to
-ms.date: 09/27/2022
+ms.date: 11/27/2023
 ms.author: greglin
 ---
 
@@ -21,9 +21,9 @@ To create a record set in the Azure portal, see [Create DNS records by using the
 
 ## View a record set
 
-1. In the Azure portal, go to the **DNS zone** overview page.
+1. In the Azure portal, go to the **DNS zones** overview page.
 
-1. Search for the record set and select it will open the record set properties.
+1. Select your DNS zone. The current record sets are displayed.
 
     :::image type="content" source="./media/dns-operations-recordsets-portal/overview.png" alt-text="Screenshot of contosotest.com zone overview page.":::
 

articles/dns/index.yml

@@ -11,7 +11,7 @@ metadata:
   ms.topic: landing-page
   author: greg-lindsay
   ms.author: greglin
-  ms.date: 09/27/2022
+  ms.date: 11/27/2023
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new