diff --git a/test/src/main/java/org/jvnet/hudson/test/HudsonTestCase.java b/test/src/main/java/org/jvnet/hudson/test/HudsonTestCase.java
index 008f0f080f..de931754e8 100644
--- a/test/src/main/java/org/jvnet/hudson/test/HudsonTestCase.java
+++ b/test/src/main/java/org/jvnet/hudson/test/HudsonTestCase.java
@@ -195,7 +195,9 @@ import jenkins.model.JenkinsLocationConfiguration;
*
* @see Wiki article about unit testing in Hudson
* @author Kohsuke Kawaguchi
+ * @deprecated New code should use {@link JenkinsRule}.
*/
+@Deprecated
@SuppressWarnings("rawtypes")
public abstract class HudsonTestCase extends TestCase implements RootAction {
/**
diff --git a/test/src/main/java/org/jvnet/hudson/test/JenkinsRule.java b/test/src/main/java/org/jvnet/hudson/test/JenkinsRule.java
index 446f3383f8..27bd142e77 100644
--- a/test/src/main/java/org/jvnet/hudson/test/JenkinsRule.java
+++ b/test/src/main/java/org/jvnet/hudson/test/JenkinsRule.java
@@ -217,9 +217,9 @@ import static org.junit.matchers.JUnitMatchers.containsString;
import org.junit.rules.TemporaryFolder;
/**
- * JUnit 4.10+ style rule to allow test cases to fire up a Jenkins instance
+ * JUnit rule to allow test cases to fire up a Jenkins instance.
*
- * @see Wiki article about unit testing in Jenkins
+ * @see Wiki article about unit testing in Jenkins
* @author Stephen Connolly
* @since 1.436
*/