From a05cdaf018688491625066c0041a4686301d4bc2 Mon Sep 17 00:00:00 2001
From: Alexander Esgen <alexander.esgen@tweag.io>
Date: Wed, 23 Aug 2023 10:42:38 +0200
Subject: [PATCH] users-guide: remove note about fatal Haddock parse failures

---
 docs/users_guide/using.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/users_guide/using.rst b/docs/users_guide/using.rst
index 6c42a9eccfa4..de9d7674ed3b 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
 -------------------
-- 
GitLab