diff --git a/docs/rules/html-has-lang.md b/docs/rules/html-has-lang.md
index e99c390ec..649706e0c 100644
--- a/docs/rules/html-has-lang.md
+++ b/docs/rules/html-has-lang.md
@@ -1,6 +1,6 @@
# html-has-lang
- elements must have the lang prop.
+ elements must have the lang prop. This rule is largely superseded by the [`lang` rule](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/master/docs/rules/lang.md).
## Rule details