diff --git a/core/src/main/java/feign/BaseBuilder.java b/core/src/main/java/feign/BaseBuilder.java
index e89681476..8943ab67e 100644
--- a/core/src/main/java/feign/BaseBuilder.java
+++ b/core/src/main/java/feign/BaseBuilder.java
@@ -164,7 +164,7 @@ public B dismiss404() {
    * {@link #client(Client) client}.
    *
    * @since 8.12
-   * @deprecated
+   * @deprecated use {@link #dismiss404()} instead.
    */
   @Deprecated
   public B decode404() {