Update documentation

Author: sevanspowell

docs/dev/coverage.md

@@ -47,16 +47,7 @@ The coverage information generated will look something like this:
             │   └── my-test-1
             │       └── my-test-1.tix
             └── html
-                ├── my-library-0.1.0.0
-                │   ├── my-library-0.1.0.0-ERSaOroBZhe9awsoBkhmcV
-                │   │   ├── My.Lib.Config.hs.html
-                │   │   ├── My.Lib.Types.hs.html
-                │   │   └── My.Lib.Util.hs.html
-                │   ├── hpc_index_alt.html
-                │   ├── hpc_index_exp.html
-                │   ├── hpc_index_fun.html
-                │   └── hpc_index.html
-                └── my-test-1
+                └── my-library-0.1.0.0
                     ├── my-library-0.1.0.0-ERSaOroBZhe9awsoBkhmcV
                     │   ├── My.Lib.Config.hs.html
                     │   ├── My.Lib.Types.hs.html
@@ -79,11 +70,6 @@ The coverage information generated will look something like this:
   respective tix files.
   - `html/my-library-0.1.0.0/hpc_index.html` contains coverage
     information for the library, excluding any test modules.
-  - `html/my-test-1/hpc_index.html` contains the coverage information
-    that the test contributes to the library, excluding any test modules.
-    - The library might have 100% coverage, 50% generated by test-1
-      and 50% generated by test-2. The HTML reports for each test will
-      only show 50% coverage, but the library will show 100% coverage.
 
 ### Project-wide reports
 
@@ -132,32 +118,14 @@ like this:
                 │   ├── hpc_index_exp.html
                 │   ├── hpc_index_fun.html
                 │   └── hpc_index.html
-                ├── my-test-1
-                │   ├── my-library-0.1.0.0-ERSaOroBZhe9awsoBkhmcV
-                │   │   ├── My.Lib.Config.hs.html
-                │   │   ├── My.Lib.Types.hs.html
-                │   │   └── My.Lib.Util.hs.html
-                │   ├── hpc_index_alt.html
-                │   ├── hpc_index_exp.html
-                │   ├── hpc_index_fun.html
-                │   └── hpc_index.html
-                ├── other-libray-0.1.0.0
-                │   ├── other-library-0.1.0.0-48EVZBwW9Kj29VTaRMhBDf
-                │   │   ├── Other.Lib.A.hs.html
-                │   │   └── Other.Lib.B.hs.html
-                │   ├── hpc_index_alt.html
-                │   ├── hpc_index_exp.html
-                │   ├── hpc_index_fun.html
-                │   └── hpc_index.html
-                ├── other-test-1
-                │   ├── other-library-0.1.0.0-48EVZBwW9Kj29VTaRMhBDf
-                │   │   ├── Other.Lib.A.hs.html
-                │   │   └── Other.Lib.B.hs.html
-                │   ├── hpc_index_alt.html
-                │   ├── hpc_index_exp.html
-                │   ├── hpc_index_fun.html
-                │   └── hpc_index.html
-                └── index.html
+                └── other-libray-0.1.0.0
+                    ├── other-library-0.1.0.0-48EVZBwW9Kj29VTaRMhBDf
+                    │   ├── Other.Lib.A.hs.html
+                    │   └── Other.Lib.B.hs.html
+                    ├── hpc_index_alt.html
+                    ├── hpc_index_exp.html
+                    ├── hpc_index_fun.html
+                    └── hpc_index.html
 ```
 
 All of the coverage information is copied verbatim from the coverage

docs/tutorials/coverage.md

@@ -39,9 +39,9 @@ in {
 nix-build default.nix -A "projectWithCoverage.$pkg.coverageReport"
 ```
 
-This will generate a coverage report for the package you requested. By
-default, all tests that are enabled (configured with
-`doCheck == true`) are included in the coverage report.
+This will generate a coverage report for the package you requested.
+All tests that are enabled (configured with `doCheck == true`) are
+included in the coverage report.
 
 See the [developer coverage docs](../dev/coverage.md#package-reports) for more information.
 
@@ -62,7 +62,7 @@ By default, `projectCoverageReport` generates a coverage report
 including all the packages in your project, and `coverageReport`
 generates a report for the library and all enabled tests in the
 requested package. You can modify what is included in each report by
-using the `coverageReport` and `projectCoverageReport` functions.
+using the `coverageReport'` and `projectCoverageReport'` functions.
 These are found in the haskell.nix library:
 
 ```nix