Skip to content

skill(apm-integrations): clarify + consolidate Groovy-vs-Java test DSL rule - #12359

Draft
jordan-wong wants to merge 2 commits into
masterfrom
skill/dedup-groovy-java-dsl-guidance
Draft

skill(apm-integrations): clarify + consolidate Groovy-vs-Java test DSL rule#12359
jordan-wong wants to merge 2 commits into
masterfrom
skill/dedup-groovy-java-dsl-guidance

Conversation

@jordan-wong

@jordan-wong jordan-wong commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Clarifies the Groovy-vs-Java test DSL rule so it's stated once instead of ambiguously in one place.

Changes

references/tests.md §1 rewrote "Full Java instrumentation test support is not yet available" — which reads as if Java/JUnit tests are unavailable, but the repo has real Java-DSL instrumentation test suites — into a plain, unconditional statement: Groovy/Spock for new instrumentation tests; an existing Java-DSL sibling is not license to add more Java tests, and is not license to migrate a Groovy family to Java either. SKILL.md and the banner-comments section point to this one statement instead of restating it, so there's a single place to update.

Scope

references/tests.md, SKILL.md — docs-only.

Follows up on #12164 (which introduced a conditional exception that was flagged as contradicting repo convention — this PR states the rule plainly instead).

… source of truth

"Full Java instrumentation test support is not yet available" read as an absolute ban,
but the repo has real Java/JUnit instrumentation test suites for module families
already on that DSL. Rewrote the rule to state plainly: Groovy/Spock is unconditional
for new tests; an existing Java-DSL sibling is not license to add more Java tests, and
is not license to migrate a Groovy family to Java either.

Stated once in tests.md (the single source of truth); SKILL.md and the banner-comments
section point to it rather than restating it, so there's one place to update instead of
several with slightly different wording.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jordan-wong jordan-wong added tag: ai generated Largely based on code generated by an AI or LLM tag: apm integration toolkit Changes generated by DataDog/apm-instrumentation-toolkit as part of IDM AIT experimentation labels Sep 1, 2026
@dd-octo-sts

dd-octo-sts Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

🟢 Java Benchmark SLOs — All performance SLOs passed

Suite Status
Startup 🟢 pass

SLO thresholds are defined here based on automatically generated metrics. A warning is raised when results are within 5% of the threshold.

PR vs. master results
Scenario Candidate master Δ (95% CI of mean)
startup:insecure-bank:iast:Agent 14.80 s 14.75 s [-0.4%; +1.2%] (no difference)
startup:insecure-bank:tracing:Agent 13.60 s 13.73 s [-1.9%; +0.0%] (no difference)
startup:petclinic:appsec:Agent 16.96 s 16.66 s [+0.8%; +2.8%] (maybe worse)
startup:petclinic:iast:Agent 16.88 s 16.92 s [-0.9%; +0.5%] (no difference)
startup:petclinic:profiling:Agent 16.75 s 16.82 s [-1.5%; +0.7%] (no difference)
startup:petclinic:sca:Agent 16.82 s 16.60 s [+0.3%; +2.2%] (maybe worse)
startup:petclinic:tracing:Agent 15.59 s 16.20 s [-7.8%; +0.3%] (no difference)

Commit: f4f909d6 · CI Pipeline · Benchmarking Platform UI


Load and DaCapo benchmarks can be triggered manually in the GitLab pipeline. Results will appear in the Benchmarking Platform UI after completion.

@jordan-wong jordan-wong changed the title skill(apm-integrations): clarify Groovy-vs-Java test DSL rule skill(apm-integrations): clarify + consolidate Groovy-vs-Java test DSL rule Sep 1, 2026
- SKILL.md Step 4: collapsed the 2-line source-layout bullet into the directory-creation
  line; test dir is already governed by Step 9.1, no need to name it twice.
- tests.md: cut the TagsMatcher.defaultTags()/_dd.svc_src mechanism detail from the DSL
  rule — the consequence ("diverges from master's style, trips the stricter tag matcher")
  is enough for the rule; the exact internals aren't needed to follow it.
- tests.md banner-comments section: replaced a full caveat sentence with a one-line
  comment inside the code fence itself, next to the code it's caveating.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tag: ai generated Largely based on code generated by an AI or LLM tag: apm integration toolkit Changes generated by DataDog/apm-instrumentation-toolkit as part of IDM AIT experimentation type: documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant