[DOCS-15344] Migrate Live Debugger to Cdocs - #39022
Open
domalessi wants to merge 8 commits into
Open
Conversation
Adds a prog_lang dropdown for enablement instructions and moves language-specific setup content into Markdoc partials. Co-authored-by: Cursor <cursoragent@cursor.com>
github-actions
Bot
added
Architecture
Contributor
Preview links (active after the
|
Remove partials in favor of conditional blocks in the parent cdoc. Co-authored-by: Cursor <cursoragent@cursor.com>
Move duplicated in-app instructions into one conditional block for Java, Python, .NET, and Node.js. Co-authored-by: Cursor <cursoragent@cursor.com>
Remove dropdown instruction text and in-app version table. Enablement section now focuses on setup steps only. Co-authored-by: Cursor <cursoragent@cursor.com>
jhgilbert
added
the
astro-reorg-no-conflicts
Co-authored-by: Cursor <cursoragent@cursor.com>
Split host vs Datadog requirements and separate in-app, env-var, and enablement-mode setup so each language shows a clear path. Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
domalessi
added
editorial review
Contributor
Author
|
Editorial review: https://datadoghq.atlassian.net/browse/DOCS-15611 |
brett0000FF
approved these changes
Sep 4, 2026
Comment on lines
+68
to
+71
| - **[Datadog Java SDK][30]**, version 1.64.0 or higher strongly recommended (JDK 8 or higher); versions below 1.64.0 may result in unexpected errors and a degraded experience | ||
| - Minimum for [in-app enablement](#enable-in-app): 1.48.0 | ||
| - Minimum for [manual enablement](#enable-with-environment-variables): 1.42.0 | ||
| - **[Datadog Agent][2]**, version 7.49.0 or higher |
Collaborator
There was a problem hiding this comment.
Suggested change
| - **[Datadog Java SDK][30]**, version 1.64.0 or higher strongly recommended (JDK 8 or higher); versions below 1.64.0 may result in unexpected errors and a degraded experience | |
| - Minimum for [in-app enablement](#enable-in-app): 1.48.0 | |
| - Minimum for [manual enablement](#enable-with-environment-variables): 1.42.0 | |
| - **[Datadog Agent][2]**, version 7.49.0 or higher | |
| - [Datadog Java SDK][30], version 1.64.0 or higher strongly recommended (JDK 8 or higher); versions below 1.64.0 may result in unexpected errors and a degraded experience | |
| - Minimum for [in-app enablement](#enable-in-app): 1.48.0 | |
| - Minimum for [manual enablement](#enable-with-environment-variables): 1.42.0 | |
| - [Datadog Agent][2], version 7.49.0 or higher |
Bolding link text doubles up on emphasis.
Comment on lines
+173
to
+178
| Update `system-probe.yaml` (located alongside `datadog.yaml`) with the following. For more information, see [Agent configuration files][37]. | ||
|
|
||
| ```yaml | ||
| dynamic_instrumentation: | ||
| enabled: true | ||
| ``` |
Collaborator
There was a problem hiding this comment.
Suggested change
| Update `system-probe.yaml` (located alongside `datadog.yaml`) with the following. For more information, see [Agent configuration files][37]. | |
| ```yaml | |
| dynamic_instrumentation: | |
| enabled: true | |
| ``` | |
| Update `system-probe.yaml` (located alongside `datadog.yaml`) with the following: | |
| ```yaml | |
| dynamic_instrumentation: | |
| enabled: true | |
| ``` | |
| For more information, see [Agent configuration files][37]. |
Moving the cross-reference after the code block keeps the colon-then-fence pattern consistent with the Environment variable and Helm tabs.
|
|
||
| #### Enable with environment variables {% #enable-with-environment-variables %} | ||
|
|
||
| {% if includes($prog_lang, ["java", "python", "dot_net", "node_js"]) %} |
Collaborator
There was a problem hiding this comment.
Go is included in the outer if here and has an in-app minimum (2.6.0) listed in Requirements, but it's excluded from this framing sentence, so a Go reader jumps straight from the "Enable with environment variables" heading to the shared code block with no lead-in.
Is that intentional? If so, it might be worth a short Go-specific sentence so the section doesn't read as if a line went missing.
Comment on lines
+412
to
+413
| - **Configuration scope:** Live Debugger and Dynamic Instrumentation are enabled or disabled together for the same service and environment. | ||
| - **Rate limits:** |
Collaborator
There was a problem hiding this comment.
Suggested change
| - **Configuration scope:** Live Debugger and Dynamic Instrumentation are enabled or disabled together for the same service and environment. | |
| - **Rate limits:** | |
| - **Configuration scope**: Live Debugger and Dynamic Instrumentation are enabled or disabled together for the same service and environment. | |
| - **Rate limits**: |
Keeping this consistent with other bullets on the page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do? What is the motivation?
Fixes DOCS-15344
Migrates the Live Debugger page to Cdocs with a language dropdown (Java, Python, .NET, Node.js, Ruby, PHP, Go). Language-specific enablement instructions live in Markdoc partials; shared content stays in the parent page.
Also removes the orphaned Spanish translation file flagged by the Cdocs pre-commit hook.
Merge readiness
For Datadog employees:
<name>/<description>convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR./reviewto run an automated check that catches common issues before a Documentation team member reviews your PR.AI assistance
Claude Code assisted with Cdocs migration structure, Markdoc conversion, and partial extraction.
Additional notes
Made with Cursor