Skip to content

Commit efe2124

Browse files
Update Team Management docs for the unified team page (#38036)
* Update Team Management docs for the unified team page * Remove mapview reference * Condense details sections * Replace spaced em dashes with colons to satisfy Vale --------- Co-authored-by: Toma <tom.nof@datadoghq.com>
1 parent 152d78a commit efe2124

1 file changed

Lines changed: 32 additions & 33 deletions

File tree

content/en/account_management/teams/manage.md

Lines changed: 32 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -7,46 +7,43 @@ description: Customize team pages, manage membership, set up subteams, and confi
77

88
Each team has a detail page that displays information about the team, its members, and its associated resources. Navigate to a team detail page by clicking on a team from the [Teams directory][1].
99

10-
The team page displays the following resources associated with your team:
11-
- Dashboards
12-
- Notebooks
13-
- Monitors
14-
- Services
15-
- Links
16-
- Ongoing incidents
17-
- API endpoints
10+
The team detail page is organized into three tabs:
1811

19-
You can change which resources are shown and their order on the page.
12+
- **Info**: Core team details and membership.
13+
- **Resources**: The Datadog resources associated with the team.
14+
- **On-Call**: The team's [Datadog On-Call][6] configuration.
2015

21-
Customize the look of your team by choosing an emoji avatar and banner. The emoji avatar displays next to the team name in lists across Datadog.
16+
The team header displays the team's avatar, banner, name, and description. Customize the look of your team by choosing an emoji avatar and banner. The emoji avatar displays next to the team name in lists across Datadog.
2217

23-
See the following instructions to customize your team.
18+
### Info tab
2419

25-
### Customize layout
20+
Core team details: notification channels, links, connections, hierarchy (parent team and subteams), and members.
2621

27-
To modify the team page layout, you must have the `user_access_manage` or `teams_manage` permission. Alternately, you can be a team member or team manager of a team that is configured to allow members and managers to edit team details.
22+
### Resources tab
2823

29-
1. Click {{< ui >}}Page Layout{{< /ui >}}. The page layout dialog appears.
30-
1. To reorder the resources, click and drag the drag handle icons.
31-
1. To hide a resource, mouse over an item and click the eye ({{< ui >}}Hide content{{< /ui >}}) icon.
24+
The Datadog resources the team owns, grouped by area such as productivity, software, performance, and cloud cost. If the team has subteams, use the **Include Subteams** toggle to show their resources alongside the team's own.
3225

33-
Hidden resources appear at the bottom of the page layout dialog. To reveal a resource, mouse over it and click the {{< ui >}}Unhide content{{< /ui >}} icon.
26+
### On-Call tab
27+
28+
The team's [Datadog On-Call][6] setup: members, schedules, escalation policies, routing, and handover automation.
3429

3530
### Customize settings
3631

37-
To modify the team details, you must have the `user_access_manage` or `teams_manage` permission. Alternately, you can be a team member or team manager of a team that is configured to allow members and managers to edit team details.
32+
To modify a team's details, you must have the `user_access_manage` or `teams_manage` permission. Alternately, you can be a team member or team manager of a team that is configured to allow members and managers to edit team details.
33+
34+
Edit a team's details directly from its detail page:
3835

39-
Click {{< ui >}}Settings{{< /ui >}}. The settings dialog appears.
36+
- **Avatar, name, and description**: Mouse over the team name and click the edit (pencil) icon.
37+
- **Banner**: Mouse over the banner and click the edit (pencil) icon.
38+
- **Info tab sections**: Mouse over a section, such as Links, Members, or Notification Channels, and click its edit icon to update it in place.
4039

41-
From the settings dialog, use the menu to customize the following team settings:
42-
- Members
43-
- Links
44-
- Name and description
45-
- Avatar and banner
46-
- Page layout
47-
- Permissions
48-
- Notifications
49-
- GitHub connection
40+
Use the Settings (gear) menu in the team header for the following actions:
41+
42+
- **Configure Notifications**: Add or update the team's notification channels. Supported targets include Slack, Microsoft Teams, PagerDuty, email, and ServiceNow.
43+
- **Edit Roles and Permissions**: Manage the roles and permissions associated with the team.
44+
- **Edit Team Handle**: Change the team's handle.
45+
- **Edit Connections**: Connect the team to external systems. Connect a **GitHub team** to associate the Datadog team with a GitHub team, or connect a **ServiceNow assignment group** to route incidents and change requests automatically.
46+
- **Join Team** or **Leave Team**: Add yourself to or remove yourself from the team.
5047

5148
## Team membership
5249

@@ -56,7 +53,7 @@ To differentiate members of your team, designate some of them as team managers.
5653

5754
### Team modification permissions
5855

59-
Under the team's settings, in the {{< ui >}}Permissions{{< /ui >}} tab, specify which users can modify the team membership. The following options are available:
56+
In the team's roles and permissions settings, specify which users can modify the team membership. The following options are available:
6057
- Only users with the `user_access_manage` permission
6158
- Team managers
6259
- Team managers and members
@@ -80,7 +77,9 @@ In some cases, a team's membership cannot be directly modified within Datadog by
8077
- If your org has selected SAML as the only team provisioning source, then the SAML team mappings control team membership. You cannot modify the team membership through Datadog.
8178
- If a team is managed through an identity provider, then the identity provider controls team membership. You cannot modify the team membership through Datadog.
8279

83-
### Subteams (hierarchical teams)
80+
A team that is managed externally from an identity provider displays a **Managed** badge in its header.
81+
82+
### Subteams (hierarchical teams)
8483

8584
{{< site-region region="gov,gov2" >}}
8685
<div class="alert alert-warning">
@@ -91,7 +90,7 @@ This feature is not supported for your selected Datadog site ({{< region-param k
9190
With subteams, you can nest teams within each other to mimic your company's hierarchy in Datadog, allowing for a more complete and accurate ownership model. Subteams also provide an enhanced filtering experience; select a larger team (like a director-level group) to find all the data connected to any of its subteams.
9291
{{< img src="account_management/teams/teams_filter_hierarchies.png" alt="Filter Hierarchical Teams" >}}
9392

94-
On the {{< ui >}}Subteams{{< /ui >}} tab, you can add and remove existing teams. For a clear view of a team's place in its hierarchy, go to [**Teams** > **Map View**][4], then search for the team by name.
93+
A team's subteams appear in the **Hierarchy** section of its Info tab.
9594
To automate subteam management based on your organization's hierarchical structure, use the [Teams APIs][5].
9695

9796
## Manage teams through an identity provider
@@ -101,7 +100,7 @@ When you set up a managed team, you configure the following properties of the te
101100
- Team handle
102101
- Team membership (synchronized from the corresponding identity provider group)
103102

104-
To ensure that managed teams stay consistent with their configuration in your identity provider, you must make changes to managed properties in the identity provider, not through the Datadog site or API.
103+
To keep managed teams consistent with their configuration in your identity provider, make changes to managed properties in the identity provider rather than through the Datadog site or API.
105104

106105
Datadog supports Okta and other SCIM-compliant identity providers for managed teams.
107106

@@ -122,5 +121,5 @@ To enforce a strict membership model, configure your default team settings so {{
122121
[1]: https://app.datadoghq.com/organization-settings/teams
123122
[2]: /account_management/saml/mapping/#map-saml-attributes-to-teams
124123
[3]: /account_management/scim/
125-
[4]: https://app.datadoghq.com/teams/map
126124
[5]: /api/latest/teams/#add-a-member-team
125+
[6]: /incident_response/on-call/

0 commit comments

Comments
 (0)