Skip to content

Migrate the session replay mobile setup instructions to Cdocs #29079

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 30 commits into
base: master
Choose a base branch
from

Conversation

jhgilbert
Copy link
Contributor

@jhgilbert jhgilbert commented Apr 30, 2025

What does this PR do? What is the motivation?

This converts the RUM Session Replay setup instructions to Markdoc. These instructions are used on two different pages, so I put the instructions in a partial, and converted both parent pages to .mdoc.md.

Impacted pages:

Notes for the websites team

The bump of the cdocs-hugo-integration package is just to fix header links, as you can see in the integration CHANGELOG.

Notes for all reviewers

In Cdocs, code blocks are not collapsible by default. This was an oversight, but I actually prefer it here, and in general -- our code blocks are not very deep to begin with, so in most cases it seems like the utility of the toggle isn't worth the clutter of it. Regardless, I'll check in with Kari on this. If she wants them to collapse by default, I'll make the update in Cdocs, and the code blocks in these pages will once again be collapsible. I don't consider this a blocker.

There is no new content in this PR, just the setup of content filters and replacing Hugo shortcodes with Markdoc tags (like replacing tabs with if tags).

I've tweaked some Prettier/VS Code settings to fix some annoying issues around autoformatting / the Markdoc language server not providing code folding in some files.

I have QA'd these pages using the relevant items from the Cdocs QA list. I'm mainly just looking for a sanity check that nothing looks odd.

The features being QA'd for the first time are:

  • Preferences being remembered between pages (you can check the two pages against one another -- even if you visit the plain URL of the second page, the URL params should repopulate and match what you chose on the first page)
  • The use of the partial tag
  • Links to specific page headers (these were broken in a known issue until now), such as this link, which is broken in prod at the moment

Merge readiness:

  • Ready for merge

For Datadog employees:
Merge queue is enabled in this repo. Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass in 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.

To have your PR automatically merged after it receives the required reviews, add the following PR comment:

/merge

Additional notes

@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Apr 30, 2025
@jhgilbert jhgilbert changed the title Draft pilot doc 3 (Session Replay mobile setup) Migrate the session replay mobile setup instructions to Cdocs Apr 30, 2025
@jhgilbert jhgilbert added the WORK IN PROGRESS No review needed, it's a wip ;) label May 20, 2025
@jhgilbert jhgilbert marked this pull request as ready for review May 20, 2025 21:25
@jhgilbert jhgilbert requested review from a team as code owners May 20, 2025 21:25
@jhgilbert jhgilbert added editorial review Waiting on a more in-depth review and removed WORK IN PROGRESS No review needed, it's a wip ;) labels May 20, 2025
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 editorial review Waiting on a more in-depth review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant