diff --git a/crates/oxc_linter/src/rules/eslint/no_throw_literal.rs b/crates/oxc_linter/src/rules/eslint/no_throw_literal.rs
index 7b360a6df70fc..0d7bf3e554a9d 100644
--- a/crates/oxc_linter/src/rules/eslint/no_throw_literal.rs
+++ b/crates/oxc_linter/src/rules/eslint/no_throw_literal.rs
@@ -22,6 +22,10 @@ declare_oxc_lint!(
     ///
     /// Disallows throwing literals or non-Error objects as exceptions.
     ///
+    /// ::: warning
+    /// This rule has been deprecated, please instead use [typescript/only-throw-error](https://oxc.rs/docs/guide/usage/linter/rules/typescript/only-throw-error.html).
+    /// The typescript rule is more reliable than the Javascript version, as it has less false positive, and can catch more cases.
+    ///
     /// ### Why is this bad?
     ///
     /// It is considered good practice to only throw the Error object itself or an object using