Skip to content

Conversation

janine-c
Copy link
Contributor

@janine-c janine-c commented Sep 3, 2025

What does this PR do? What is the motivation?

New small section on nesting teams in each other 🙂

Merge instructions

Please don't merge until we get PM approval!

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

@janine-c janine-c requested a review from a team as a code owner September 3, 2025 18:29
Copy link
Contributor

github-actions bot commented Sep 3, 2025

Preview links (active after the build_preview check completes)

Modified Files

@rtrieu rtrieu self-assigned this Sep 3, 2025
Copy link
Contributor

@rtrieu rtrieu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Contributor

@heavi5ide heavi5ide left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you! This doesn't really sell the utility of the feature at all, but maybe we're waiting for this to come out of preview phase for that? I might suggest we include something like this:

With Team Hierarchy, you can nest teams within each other to mimic your company's structure in Datadog, allowing for a more complete and accurate ownership model. Team Hierarchy also provides an enhanced filtering experience; select a larger team (like a director-level group) to find all the data connected to any of its subteams.

Not sure how well that fits into this flow, or if maybe it's more appropriate as an addition to a different section at a later time.

Teams Hierarchy is in Preview. Fill out this form to request access.
{{< /callout >}}

With subteams, you can nest teams within each other to mimic your company's structure 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since we're not using "team hierarchy," can we change from "your company's structure" back to your original use of "your company hierarchy" here? I think it's important for the word "hierarchy" to be in here a bit as my impression is that this is what customers call this feature (Tom has had multiple customer calls where they call it "hierarchy" before we do).

@janine-c janine-c merged commit 2d92065 into master Sep 4, 2025
15 checks passed
@janine-c janine-c deleted the janine.chan/docs-11773-teams-hierarchies branch September 4, 2025 19:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants