Skip to content

Update Team Management docs for the unified team page#38036

Merged
geethuannjoseph merged 5 commits into
masterfrom
geethu.joseph/team-details-page
Jul 10, 2026
Merged

Update Team Management docs for the unified team page#38036
geethuannjoseph merged 5 commits into
masterfrom
geethu.joseph/team-details-page

Conversation

@geethuannjoseph

@geethuannjoseph geethuannjoseph commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Fixes OMG-1584

Updates the Team Management documentation for the unified team page. Rewrites the team detail section around the three tabs (Info, Resources, and On-Call), documents each tab's sections and the Include Subteams toggle, updates the editing and settings instructions, and removes the obsolete Page Layout section.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

@datadog-prod-us1-6

This comment has been minimized.

@geethuannjoseph geethuannjoseph changed the title Update Team Management docs for the unified team page [OMG-1584] Update Team Management docs for the unified team page Jul 8, 2026
@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@geethuannjoseph geethuannjoseph assigned jcharry and unassigned jcharry Jul 8, 2026
@geethuannjoseph geethuannjoseph requested review from jcharry and tomnof July 8, 2026 13:15
@geethuannjoseph geethuannjoseph changed the title [OMG-1584] Update Team Management docs for the unified team page Update Team Management docs for the unified team page Jul 8, 2026
@geethuannjoseph geethuannjoseph marked this pull request as ready for review July 8, 2026 13:26
@geethuannjoseph geethuannjoseph requested a review from a team as a code owner July 8, 2026 13:26
Comment thread content/en/account_management/teams/manage.md Outdated
@geethuannjoseph geethuannjoseph requested a review from tomnof July 8, 2026 15:52
@buraizu buraizu self-assigned this Jul 8, 2026
@buraizu

buraizu commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Thanks for the PR, I've created DOCS-15062 for documentation team review

@buraizu buraizu added the editorial review Waiting on a more in-depth review label Jul 8, 2026
@buraizu buraizu removed their assignment Jul 8, 2026
Comment thread content/en/account_management/teams/manage.md Outdated
Comment thread content/en/account_management/teams/manage.md Outdated
Comment thread content/en/account_management/teams/manage.md Outdated
@tomnof

tomnof commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Overall: solid and accurate, but I'd pull it up a level.

The three-tab structure is the right backbone and the rewrite is a real improvement. My one piece of feedback is that it's drifted toward enumerating the UI rather than explaining it — most sections list every item in the tab (every resource type, every On-Call sub-section, etc.).

I've left inline suggestions to compress each tab to a one-sentence overview of what a user will find there, keeping the genuinely page-specific behavior (the Include Subteams toggle, the header edit affordances, the Managed badge). The goal is to describe the page at a level that stays true as the product evolves, and link out for the details.

@geethuannjoseph geethuannjoseph requested a review from tomnof July 9, 2026 11:55
jcharry
jcharry previously approved these changes Jul 10, 2026
@jcharry jcharry self-requested a review July 10, 2026 14:07
@jcharry jcharry dismissed their stale review July 10, 2026 14:08

sorry didn't mean to approve! dismissing review

@geethuannjoseph geethuannjoseph merged commit efe2124 into master Jul 10, 2026
19 checks passed
@geethuannjoseph geethuannjoseph deleted the geethu.joseph/team-details-page branch July 10, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants