Added nav files. Updated the documentation

Author: cbehera-newrelic

src/content/docs/apis/nerdgraph/examples/nerdgraph-teams-custom-role-tutorial renamed to src/content/docs/apis/nerdgraph/examples/nerdgraph-teams-custom-role-tutorial.mdx

@@ -17,29 +17,36 @@ freshnessValidatedDate: never
 </Callout>
 
 
-New Relic Teams lets you connect the entities you're monitoring to the Teams who own them. When you can easily see who owns an entity, you can speed up troubleshooting, enhance team collaboration, and improve your operational efficiency.
+New Relic Teams lets you connect the entities you're monitoring to the teams who own them. When you can easily see who owns an entity, you can speed up troubleshooting, enhance team collaboration, and improve your operational efficiency.
 
-We have given access to Teams to these standard roles:
-* **Read Access: **All users have read access to Teams, including metadata such as contact information, team members, and other relevant details.
-* **Modify Teams: **Users with the **Organization Product Admin** role can modify Teams. This is a new role assigned to all users who currently have the **All Product Admin role**.
-* **Create & Delete Teams: **Users with **Organization Manager** or **Authentication Manager** roles can create and delete Teams.
+## Default Teams access
 
+New Relic provides default access to Teams through these standard roles:
 
-This section provides instructions on using NerdGraph GraphQL mutations to create a custom role for managing Teams.
+* **Read Access**: All users have read access to Teams, including metadata such as contact information, team members, and other relevant details.
+* **Modify Teams**: Users with the **Organization Product Admin** role can modify Teams. This is a new role assigned to all users who currently have the **All Product Admin** role.
+* **Create & Delete Teams**: Users with **Organization Manager** or **Authentication Manager** roles can create and delete Teams.
 
-To create a Teams administrator custom role, you need to:
 
-* [Retrieve all the organization-scoped capabilities](#retrieve-organization-scoped-capabilities)
-* [Retrieve your organization ID](#retrieve-your-organization-id)
-* Find the required permission IDs for Teams
-* [Create the custom role for Teams administrator](#create-custom-role)
-* [Add the custom role to a user group](#add-custom-role-to-a-user-group)
+You might need a custom role if the default permissions don't meet your organization's needs. This tutorial shows you how to use NerdGraph GraphQL mutations to create a custom role for managing Teams.
 
+### Process overview
 
-**Prerequisites:**
+To create a Teams administrator custom role, you'll need to:
+
+1. [Retrieve all the organization-scoped capabilities](#retrieve-organization-scoped-capabilities)
+2. [Retrieve your organization ID](#retrieve-your-organization-id)
+3. [Identify the required permission IDs for Teams](#retrieve-organization-scoped-capabilities)
+4. [Create the custom role for Teams administrator](#create-custom-role)
+5. [Add the custom role to a user group](#add-custom-role-to-a-user-group)
+
+
+## Prerequisites
+
+Before you begin, ensure you have:
 
 * [General NerdGraph requirements](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph/#authentication)
-* You must be an Organization Admin to create a custom role.
+* Organization Admin role permissions to create custom roles
 
 
 ## Mutations [#mutations]
@@ -132,9 +139,11 @@ New Relic provides various NerdGraph mutations to create custom role for Team ma
 
     ```
 
-Copy and paste the information related to Teams in a text file matching the following criteria:
-* `category: MANAGE`
-* `"feature"``: "Teams"`
+    **Next step**: From the response, identify and copy the permission IDs where:
+    * `category: "MANAGE"` (or the appropriate category for your needs)
+    * `feature: "Teams"`
+    
+    You'll need these IDs for the next step.
 
 
 
@@ -143,8 +152,7 @@ Copy and paste the information related to Teams in a text file matching the foll
     id="retrieve-your-organization-id"
     title="Retrieve your organization ID">
 
-Fetch your organization ID to use in various mutations further.
-
+Retrieve your organization ID, which you'll use in subsequent mutations.
 
 #### Sample request
 
@@ -174,14 +182,14 @@ Fetch your organization ID to use in various mutations further.
 
   ```
 
-Copy the organization ID and keep it aside to create a role.
+  **Next step**: Copy your organization ID from the response. You'll need it to create the custom role.
 
   </Collapser>
   <Collapser 
     id="create-custom-role"
     title="Create custom role">
 
-Run the `customRoleCreate` mutation to create your own custom role.
+Use the `customRoleCreate` mutation to create your custom role for Teams management.
 
 
 #### Input parameters
@@ -215,10 +223,10 @@ Run the `customRoleCreate` mutation to create your own custom role.
       <td>The name of the role.</td>
     </tr>
     <tr>
-      <td>`PermissionId`</td>
-      <td>Int</td>
+      <td>`permissionId`</td>
+      <td>Array of Integers</td>
       <td>Yes</td>
-      <td>List the ID's for the feature retrieved using `customerAdministration` mutations for Teams.</td>
+      <td>The permission IDs for Teams features retrieved in the first step.</td>
     </tr>
     <tr>
       <td>`scope`</td>
@@ -259,34 +267,19 @@ mutation {
 
 ```
 
-<table>
-  <thead>
-    <tr>
-      <th>Parameter</th>
-      <th>Data Type</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>`id`</td>
-      <td>Int</td>
-      <td>The custom role ID. Copy and keep this ID for future use.</td>
-    </tr>
-  </tbody>
-</table>
+**Next step**: Save the returned role ID. You'll need it to assign this role to a user group.
 
   </Collapser>
 
   <Collapser 
     id="add-custom-role-to-a-user-group"
     title="Add custom role to a user group">
 
-After you have created the custom role, you must associate this role with a user group on the New Relic platform.  
+After creating the custom role, you need to assign it to a user group in New Relic.
 
-### Fetch the group ID
+### Step 1: Retrieve group IDs
 
-You can use `customerAdministration` mutation to retrieve the list of group ID's.
+Use the `customerAdministration` mutation to get a list of available user groups.
 
 
 #### Input parameters
@@ -334,11 +327,11 @@ You can use `customerAdministration` mutation to retrieve the list of group ID's
 
 ```
 
-From the displayed list of group IDs, copy the desired group ID to associate the custom Scorecard role you created earlier. 
+**Next step**: From the response, copy the group ID for the group you want to assign the Teams role to.
 
-### Add the rule to a user group
+### Step 2: Assign the role to a user group
 
-You can use `authorizationManagementGrantAccess` mutation to add the role to a user group.
+Use the `authorizationManagementGrantAccess` mutation to assign the custom role to a user group.
 
 
 #### Input parameters
@@ -357,13 +350,13 @@ You can use `authorizationManagementGrantAccess` mutation to add the role to a u
       <td>`roleId`</td>
       <td>String</td>
       <td>Yes</td>
-      <td>The custom role ID created in the [Custom role]() section.</td>
+      <td>The custom role ID from the previous step.</td>
     </tr>
     <tr>
       <td>`groupId`</td>
       <td>String</td>
-      <td>No</td>
-      <td>The group ID retrieved in the previous step.</td>
+      <td>Yes</td>
+      <td>The group ID from Step 1.</td>
     </tr>
   </tbody>
 </table>
@@ -411,3 +404,13 @@ mutation {
 ```
   </Collapser>
 </CollapserGroup>
+
+## What's next
+
+After successfully creating and assigning your custom Teams role, users in the assigned group will have the permissions you configured. You can:
+
+* Monitor the role's usage through your organization's user management
+* Modify the role permissions if needed using similar NerdGraph mutations
+* Create additional custom roles for different levels of Teams access
+
+For more information about Teams, see our [Teams documentation](/docs/service-architecture-intelligence/teams/teams/).

src/nav/telemetry-data-platform.yml

@@ -214,6 +214,8 @@ pages:
             path: /docs/apis/nerdgraph/examples/nerdgraph-api-secret-management-service
           - title: Teams tutorial
             path: /docs/apis/nerdgraph/examples/nerdgraph-teams-tutorial
+          - title: Custom role for Teams
+            path: /docs/apis/nerdgraph/examples/nerdgraph-teams-custom-role-tutorial
       - title: REST APIs
         pages:
           - title: REST API v2