Skip to content

[DOCS-13678] Rename "workload selection" to "instrumentation rules" across SSI docs#35448

Draft
domalessi wants to merge 2 commits intomasterfrom
dominique.alessi/DOCS-13678-ssi-terminology-updates
Draft

[DOCS-13678] Rename "workload selection" to "instrumentation rules" across SSI docs#35448
domalessi wants to merge 2 commits intomasterfrom
dominique.alessi/DOCS-13678-ssi-terminology-updates

Conversation

@domalessi
Copy link
Contributor

What does this PR do? What is the motivation?

Fixes DOCS-13678

Renames the "workload selection" feature terminology to "instrumentation rules" across the APM Single Step Instrumentation docs. Also updates the injectors.md understanding guide to reflect the new CSI driver mechanism for library mounting in Kubernetes.

Files changed:

  • content/en/tracing/trace_collection/single-step-apm/kubernetes.md
  • content/en/tracing/trace_collection/single-step-apm/linux.md
  • content/en/tracing/trace_collection/single-step-apm/troubleshooting.md
  • content/en/tracing/guide/injectors.md

Terminology approach:

  • General usage: "workload selection" → "instrumentation rules"
  • Kubernetes-specific: preserved the noun "workloads" where it has a specific Kubernetes meaning (e.g., "Use instrumentation rules to target specific workloads")

Open questions

  • Linux UI label (linux.md, step 1): The navigation path currently reads APM > Service Setup > Workload Selection. Needs PM confirmation — is the UI menu item being renamed to "Instrumentation Rules", or does it remain "Workload Selection"? Holding on this change until confirmed. The screenshot (workload_selection_landing.png) and its alt text will also need updating when the UI is renamed.

  • CSI driver in injectors.md: The Kubernetes section now reads "Use the Datadog CSI driver to mount the injector and tracer libraries" (replacing the init containers reference). Engineering confirmed this specific line should change, but the adjacent bullet "Mount volumes to persist injected libraries" may also be outdated given the CSI driver mechanism. Needs engineer confirmation on whether that bullet should be updated or removed.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

PR is in draft pending resolution of the open questions above.

Made with Cursor

domalessi and others added 2 commits March 20, 2026 16:10
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…s SSI docs

Also updates injectors.md to reflect new CSI driver mechanism.

Made-with: Cursor
@github-actions github-actions bot added the Guide Content impacting a guide label Mar 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant