diff --git a/cabal.project b/cabal.project
index 1f610d2501c246075300333d67a4947b8316e98d..907bfbbd99341ee2be50c049930da66316a5fcd6 100644
--- a/cabal.project
+++ b/cabal.project
@@ -7,8 +7,12 @@ constraints: unix >= 2.7.1.0,
 
 program-options
   -- So us hackers get all the assertion failures early:
-  -- NOTE: currently commented out, see https://github.com/haskell/cabal/issues/3911
+  --
+  -- NOTE: currently commented out, see
+  -- https://github.com/haskell/cabal/issues/3911
+  --
   -- ghc-options: -fno-ignore-asserts
+  --
   -- as a workaround we specify it for each package individually:
 package Cabal
   ghc-options: -fno-ignore-asserts