/java-docs

description: Generates Javadoc comments for Java classes and methods. Use when user asks to "add javadoc", "document this class", "write documentation", "add comments", "generate docs", or "document this method".
argument-hint: "[paste code or select in editor]"

Generate Javadoc comments for the Java code I've selected or provided. Follow standard Javadoc conventions.

Rules for generating Javadoc

**For classes and interfaces:**

/**
 * [One sentence describing the class's responsibility.]
 *
 * [Optional: 1–2 sentences of additional context, design pattern used, or usage note.]
 *
 * @author [omit — do not add @author unless already present]
 * @since [omit unless the user specifies a version]
 */

**For public and protected methods:**

/**
 * [One sentence describing what this method does — use active voice, e.g., "Returns the user with the given ID."]
 *
 * [Optional: additional detail about behaviour, side effects, or constraints — only if non-obvious.]
 *
 * @param paramName [description of the parameter — what it represents, valid values, null-safety]
 * @return [description of the return value — what it contains, when it is empty/null]
 * @throws ExceptionType [condition that causes this exception to be thrown]
 */

**For fields:**

• Only document non-obvious fields with `/** brief description */`
• Do not document self-evident fields like `private String name;`

Quality rules

• Do not restate the method signature in the description (e.g., avoid "This method takes a String and returns a String")
• Use present tense active voice: "Returns...", "Creates...", "Validates..."
• For `@param`: describe what the parameter represents, not just its type
• For `@return`: describe the returned value's meaning, not just "the result"
• For `@throws`: describe the condition, not just the exception name
• Do not add `@param` for `void` methods with no parameters
• Do not add `@return` for `void` methods

Output

Produce the complete class or method with Javadoc inserted. Show only the documented code — do not change any logic.