Skip to content

Conversation

@rtrieu
Copy link
Contributor

@rtrieu rtrieu commented Dec 18, 2025

What does this PR do? What is the motivation?

Session Replay is now an add-on for RUM and PA, so the docs need to be standalone.

Merge instructions

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

@rtrieu rtrieu requested a review from a team as a code owner December 18, 2025 21:30
@rtrieu rtrieu added the WORK IN PROGRESS No review needed, it's a wip ;) label Dec 18, 2025
@rtrieu rtrieu requested a review from a team as a code owner December 18, 2025 21:30
@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Dec 18, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Dec 18, 2025

Preview links (active after the build_preview check completes)

New or renamed files

Removed or renamed files (these should redirect)

Renamed files

Modified Files

@rtrieu rtrieu requested review from a team as code owners December 19, 2025 22:53
@github-actions github-actions bot added the cdocs label Dec 19, 2025
@github-actions github-actions bot added the Images Images are added/removed with this PR label Dec 19, 2025
@github-actions github-actions bot added the Guide Content impacting a guide label Dec 22, 2025
Copy link
Contributor

@joepeeples joepeeples left a comment

Choose a reason for hiding this comment

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

Nice work! Almost all my comments are non-blocking edit suggestions, but I did find a broken link to resolve.

I also noted some discrepancy with terms like Click map vs. Clickmap, which might be a bit out of scope for a reorg PR like this, but I figured I'd note it just for awareness.

Comment on lines 149 to 164
{{< tabs >}}
{{% tab "RUM" %}}

Use the [RUM Analytics explorer][1] to explore and analyze your user data.

[1]: /real_user_monitoring/explorer/

{{% /tab %}}
{{% tab "Product Analytics" %}}

Use the [Product Analytics explorer][1] to explore and analyze your user data.

[1]: /product_analytics/charts/analytics_explorer/

{{% /tab %}}
{{< /tabs >}}
Copy link
Contributor

@joepeeples joepeeples Dec 22, 2025

Choose a reason for hiding this comment

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

FWIW, tabs seem like more structure than needed for this short amount of text. But feel free to ignore if there are other considerations for using them.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

i agree, it feels like overkill, but there are significant enough changes that i needed some way to distinguish them. this will probably be solved with cdocs.

Copy link
Contributor

Choose a reason for hiding this comment

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

Makes sense, thanks for considering. LGTM!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

actually, decided to remove the tabs but just left them for the nav part of it (earlier around line 44).

@rtrieu rtrieu requested a review from a team as a code owner December 23, 2025 16:43
@github-actions github-actions bot added the Github Related to Github configurations label Dec 23, 2025
Copy link
Contributor

@joepeeples joepeeples left a comment

Choose a reason for hiding this comment

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

One follow-up suggestion on the tabs > bullet change, but everything LGTM!

Comment on lines +154 to +157
After analyzing heatmaps, the next step is to understand the user action by exploring related data. Watch associated [session replays][1] to see user actions in the context of their overall session, or navigate to an Analytics explorer:

- **RUM**: Use the [RUM Analytics explorer][3] to explore and analyze your user data.
- **Product Analytics**: Use the [Product Analytics explorer][4] to explore and analyze your user data.
Copy link
Contributor

Choose a reason for hiding this comment

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

This might not even need a bulleted list, because the content is nearly identical ("explore and analyze your user data"), and the explorer names themselves are very clear:

Suggested change
After analyzing heatmaps, the next step is to understand the user action by exploring related data. Watch associated [session replays][1] to see user actions in the context of their overall session, or navigate to an Analytics explorer:
- **RUM**: Use the [RUM Analytics explorer][3] to explore and analyze your user data.
- **Product Analytics**: Use the [Product Analytics explorer][4] to explore and analyze your user data.
After analyzing heatmaps, the next step is to understand the user action by exploring related data. Watch associated [session replays][1] to see user actions in the context of their overall session, or navigate to the [RUM Analytics explorer][3] or [Product Analytics explorer][4] to explore and analyze your user data.

That's a pretty chonky sentence now, so maybe we could break it up or something, but in general this info might work as regular text.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend cdocs Github Related to Github configurations Guide Content impacting a guide Images Images are added/removed with this PR WORK IN PROGRESS No review needed, it's a wip ;)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants