diff --git a/src/xdocs/checks.xml b/src/xdocs/checks.xml
index 032299b54..66feeb81c 100644
--- a/src/xdocs/checks.xml
+++ b/src/xdocs/checks.xml
@@ -438,13 +438,16 @@
| MissingDeprecated |
- This class is used to verify that both the
+ This class is used to verify that both the java.lang.Deprecated annotation is
+ present and the @deprecated Javadoc tag is present when either is present.
|
| MissingOverride |
- This class is used to verify that the |
+ This class is used to verify that the java.lang.Override annotation is present
+ when the {@inheritDoc} javadoc tag is present.
+
| MissingSwitchDefault |