From cbc899fa912f7b4f42dce505dfc0162b65ae1c5c Mon Sep 17 00:00:00 2001
From: Matthew Li <matthew.li@datadoghq.com>
Date: Fri, 28 Aug 2026 14:45:05 -0700
Subject: [PATCH] Document method comment style

---
 AGENTS.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/AGENTS.md b/AGENTS.md
index 5d71d34db0c..9bd598bbcb7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -59,6 +59,7 @@ docs/                     Developer documentation (see below)
 
 - **Formatting**: google-java-format enforced via Spotless. Run `./gradlew spotlessApply` before committing.
 - **Static imports**: Prefer static imports over class-qualified calls for call-style helpers, in both test (Assertions.assertEquals, Mockito.mock) and production code (Collections.emptyList). Wildcard imports disallowed — see CONTRIBUTING.md.
+- **Method documentation**: Document entire methods only with concise Javadoc comments (`/** ... */`), never with `//` or plain `/* ... */` comments.
 - **Instrumentation layout**: `dd-java-agent/instrumentation/{framework}/{framework}-{minVersion}/`
 - **Instrumentation pattern**: Type matching → Method matching → Advice class (bytecode advice, not AOP)
 - **Test frameworks**: Always use JUnit 5 for unit tests. Only use Groovy / Spock tests for instrumentation and smoke tests.