Reformat skipped benchmarks to match other sections

build-constraints.yaml

@@ -2898,26 +2898,36 @@ expected-haddock-failures:
 # end of expected-haddock-failures
 
 
-# Benchmarks which should not be built. Note that Stackage does *not* generally
-# build benchmarks. The difference here will be whether dependencies for these
-# benchmarks are included or not.
+# Benchmarks which should not be built. Note that Stackage builds benchmarks but does not run them.
+# By skipping a benchmark, we do not pull in the build dependencies
+# Packages should only be added here if required by `stackage-curator check'
+# or if Setup fails because of missing foreign libraries.
+# Otherwise place them in expected-benchmark-failures.
 skipped-benchmarks:
+
+    # Outdated dependencies
+    # These can periodically be checked for updates;
+    # just remove these lines and run `stackage-curator check'
+    # to verify.
     - criterion-plus
 
-    # pulls in criterion-plus, which has restrictive upper bounds
-    - cases
-    - hasql-postgres
-    - ttrie
+    # Transitive outdated dependencies
+    # These packages
+    # These can also be checked for updates periodically.
 
-    # https://github.com/vincenthz/hs-crypto-cipher/issues/46
-    - cipher-aes
-    - cipher-blowfish
-    - cipher-camellia
-    - cipher-des
-    - cipher-rc4
+    - cases # via criterion-plus
+    - hasql-postgres # via criterion-plus
+    - ttrie # via criterion-plus
 
-    # https://github.com/fpco/stackage/issues/1587
-    - hledger-lib
+    # Compilation failures
+    - cipher-aes # https://github.com/vincenthz/hs-crypto-cipher/issues/46
+    - cipher-blowfish # https://github.com/vincenthz/hs-crypto-cipher/issues/46
+    - cipher-camellia # https://github.com/vincenthz/hs-crypto-cipher/issues/46
+    - cipher-des # https://github.com/vincenthz/hs-crypto-cipher/issues/46
+    - cipher-rc4 # https://github.com/vincenthz/hs-crypto-cipher/issues/46
+
+    # GHC Bugs
+    - hledger-lib # https://github.com/fpco/stackage/issues/1587
 
 # end of skipped-benchmarks