diff --git a/docs/users_guide/using.rst b/docs/users_guide/using.rst
index 8de7dd353394e00b8d4bc166b6d10ff9f6a552e8..6695c8aa7b994c17b721cd436acccaea94eb87bf 100644
--- a/docs/users_guide/using.rst
+++ b/docs/users_guide/using.rst
@@ -1768,8 +1768,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
 -------------------