diff --git a/docs/users_guide/using.rst b/docs/users_guide/using.rst
index 6c42a9eccfa42e73fc028c917dafe3468c59971b..de9d7674ed3b23907070ee4f5f32c20e31475176 100644
--- a/docs/users_guide/using.rst
+++ b/docs/users_guide/using.rst
@@ -1765,8 +1765,8 @@ Haddock
     top-level type-signature.  With this flag GHC will parse Haddock comments
     and include them in the interface file it produces.
 
-    Note that this flag makes GHC's parser more strict so programs which are
-    accepted without Haddock may be rejected with :ghc-flag:`-haddock`.
+    Consider using :ghc-flag:`-Winvalid-haddock` to be informed about discarded
+    documentation comments.
 
 Miscellaneous flags
 -------------------