Merge pull request #210300 from baanders/9-6-titles

ADT: Clarify ADT-specific articles

Author: v-stsavell

articles/digital-twins/.openpublishing.redirection.digital-twins.json

@@ -144,7 +144,12 @@
     },
     {
       "source_path": "how-to-configure-postman.md",
-      "redirect_url": "/azure/digital-twins/how-to-use-postman",
+      "redirect_url": "/azure/digital-twins/how-to-use-postman-with-digital-twins",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "how-to-use-postman.md",
+      "redirect_url": "/azure/digital-twins/how-to-use-postman-with-digital-twins",
       "redirect_document_id": true
     },
     {
@@ -202,6 +207,16 @@
       "redirect_url": "/azure/digital-twins/how-to-manage-routes",
       "redirect_document_id": false
     },
+    {
+      "source_path": "troubleshoot-error-403.md",
+      "redirect_url": "/azure/digital-twins/troubleshoot-error-403-digital-twins",
+      "redirect_document_id": true
+    },
+    {
+      "source_path": "troubleshoot-error-404.md",
+      "redirect_url": "/azure/digital-twins/troubleshoot-error-404-digital-twins",
+      "redirect_document_id": true
+    },
     {
       "source_path": "how-to-multitenant-applications.md",
       "redirect_url": "/previous-versions/azure/digital-twins/how-to-multitenant-applications",

articles/digital-twins/TOC.yml

@@ -103,8 +103,8 @@
       href: how-to-query-graph.md
   - name: Develop client apps
     items:
-    - name: Make API requests with Postman
-      href: how-to-use-postman.md
+    - name: Call Azure Digital Twins APIs with Postman
+      href: how-to-use-postman-with-digital-twins.md
     - name: Use 3D Scenes Studio
       href: how-to-use-3d-scenes-studio.md
     - name: Write app authentication code
@@ -149,12 +149,12 @@
       href: troubleshoot-performance.md
     - name: Known issues
       href: troubleshoot-known-issues.md
-    - name: Problem resolution
+    - name: Problem resolution in Azure Digital Twins
       items:
       - name: Error 403 (Forbidden)
-        href: troubleshoot-error-403.md
+        href: troubleshoot-error-403-digital-twins.md
       - name: Error 404 (Sub-Domain not found)
-        href: troubleshoot-error-404.md
+        href: troubleshoot-error-404-digital-twins.md
       - name: Azure Digital Twins Explorer authentication error
         href: troubleshoot-error-azure-digital-twins-explorer-authentication.md
       - name: CLI parsing failures

articles/digital-twins/concepts-apis-sdks.md

@@ -17,7 +17,7 @@ ms.service: digital-twins
 
 # Azure Digital Twins APIs and SDKs
 
-This article gives an overview of the Azure Digital Twins APIs available, and the methods for interacting with them. You can either use the REST APIs directly with their associated Swaggers (through a tool like [Postman](how-to-use-postman.md)), or through an SDK.
+This article gives an overview of the Azure Digital Twins APIs available, and the methods for interacting with them. You can either use the REST APIs directly with their associated Swaggers (through a tool like [Postman](how-to-use-postman-with-digital-twins.md)), or through an SDK.
 
 Azure Digital Twins comes equipped with control plane APIs, data plane APIs, and SDKs for managing your instance and its elements. 
 * The control plane APIs are [Azure Resource Manager (ARM)](../azure-resource-manager/management/overview.md) APIs, and cover resource management operations like creating and deleting your instance. 
@@ -101,7 +101,7 @@ The available helper classes are:
 
 The following list provides more detail and general guidelines for using the APIs and SDKs.
 
-* You can use an HTTP REST-testing tool like Postman to make direct calls to the Azure Digital Twins APIs. For more information about this process, see [Make API requests with Postman](how-to-use-postman.md).
+* You can use an HTTP REST-testing tool like Postman to make direct calls to the Azure Digital Twins APIs. For more information about this process, see [Call the Azure Digital Twins APIs with Postman](how-to-use-postman-with-digital-twins.md).
 * To use the SDK, instantiate the `DigitalTwinsClient` class. The constructor requires credentials that can be obtained with different kinds of authentication methods in the `Azure.Identity` package. For more on `Azure.Identity`, see its [namespace documentation](/dotnet/api/azure.identity?view=azure-dotnet&preserve-view=true). 
 * You may find the `InteractiveBrowserCredential` useful while getting started, but there are several other options, including credentials for [managed identity](/dotnet/api/azure.identity.interactivebrowsercredential?view=azure-dotnet&preserve-view=true), which you'll likely use to authenticate [Azure functions set up with MSI](../app-service/overview-managed-identity.md?tabs=dotnet) against Azure Digital Twins. For more about `InteractiveBrowserCredential`, see its [class documentation](/dotnet/api/azure.identity.interactivebrowsercredential?view=azure-dotnet&preserve-view=true).
 * Requests to the Azure Digital Twins APIs require a user or service principal that is a part of the same [Azure Active Directory](../active-directory/fundamentals/active-directory-whatis.md) (Azure AD) tenant where the Azure Digital Twins instance exists. To prevent malicious scanning of Azure Digital Twins endpoints, requests with access tokens from outside the originating tenant will be returned a "404 Sub-Domain not found" error message. This error will be returned even if the user or service principal was given an Azure Digital Twins Data Owner or Azure Digital Twins Data Reader role through [Azure AD B2B](../active-directory/external-identities/what-is-b2b.md) collaboration. For information on how to achieve access across multiple tenants, see [Write app authentication code](how-to-authenticate-client.md#authenticate-across-tenants).
@@ -128,8 +128,8 @@ From here, you can view the metrics for your instance and create custom views.
 
 ## Next steps
 
-See how to make direct requests to the APIs using Postman:
-* [Make API requests with Postman](how-to-use-postman.md)
+See how to make direct requests to the Azure Digital Twins APIs using Postman:
+* [Call the Azure Digital Twins APIs with Postman](how-to-use-postman-with-digital-twins.md)
 
 Or, practice using the .NET SDK by creating a client app with this tutorial:
 * [Code a client app](tutorial-code.md)

articles/digital-twins/concepts-security.md

@@ -85,7 +85,7 @@ The following list describes the levels at which you can scope access to Azure D
 
 ### Troubleshoot permissions
 
-If a user attempts to perform an action not allowed by their role, they may receive an error from the service request reading `403 (Forbidden)`. For more information and troubleshooting steps, see [Troubleshoot failed service request: Error 403 (Forbidden)](troubleshoot-error-403.md).
+If a user attempts to perform an action not allowed by their role, they may receive an error from the service request reading `403 (Forbidden)`. For more information and troubleshooting steps, see [Troubleshoot Azure Digital Twins failed service request: Error 403 (Forbidden)](troubleshoot-error-403-digital-twins.md).
 
 ## Managed identity for accessing other resources
 

articles/digital-twins/how-to-send-twin-to-twin-events.md

@@ -85,7 +85,7 @@ Now, your function can receive events through your Event Grid topic. The data fl
 
 The last step is to verify that the flow is working, by updating a twin and checking that related twins are updated according to the logic in your Azure function.
 
-To kick off the process, update the twin that's the source of the event flow. You can use the [Azure CLI](/cli/azure/dt/twin#az-dt-twin-update), [Azure Digital Twins SDK](how-to-manage-twin.md#update-a-digital-twin), or [Azure Digital Twins REST APIs](how-to-use-postman.md?tabs=data-plane) to make the update.
+To kick off the process, update the twin that's the source of the event flow. You can use the [Azure CLI](/cli/azure/dt/twin#az-dt-twin-update), [Azure Digital Twins SDK](how-to-manage-twin.md#update-a-digital-twin), or [Azure Digital Twins REST APIs](how-to-use-postman-with-digital-twins.md?tabs=data-plane) to make the update.
 
 Next, query your Azure Digital Twins instance for the related twin. You can use the [Azure CLI](/cli/azure/dt/twin#az-dt-twin-query), or the [Azure Digital Twins REST APIs and SDK](how-to-query-graph.md#run-queries-with-the-api). Verify that the twin received the data and updated as expected.