From a8b4be8e3b0b07415d518a68d099ee4932823389 Mon Sep 17 00:00:00 2001
From: Dominik Nakamura <dnaka91@gmail.com>
Date: Thu, 27 May 2021 22:51:47 +0900
Subject: [PATCH] Cleanup the README using markdownlint and remove ToC (#626)

---
 .markdownlint.yaml      |  1 +
 .pre-commit-config.yaml |  4 ++
 CODE_OF_CONDUCT.md      |  1 +
 README.md               | 95 ++++++++++++++++++-----------------------
 4 files changed, 47 insertions(+), 54 deletions(-)
 create mode 100644 .markdownlint.yaml

diff --git a/.markdownlint.yaml b/.markdownlint.yaml
new file mode 100644
index 0000000..ff7d7cc
--- /dev/null
+++ b/.markdownlint.yaml
@@ -0,0 +1 @@
+MD013: false
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 4501409..ca95a6e 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -12,6 +12,10 @@ repos:
         exclude: ^test/
     -   id: mixed-line-ending
         exclude: ^test/
+-   repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.27.1
+    hooks:
+    -   id: markdownlint
 -   repo: meta
     hooks:
     -   id: check-useless-excludes
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index 041fbb6..0d424fd 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -5,6 +5,7 @@ For more details, please read the
 [Mozilla Community Participation Guidelines](https://www.mozilla.org/about/governance/policies/participation/).
 
 ## How to Report
+
 For more information on how to report violations of the Community Participation Guidelines, please read our '[How to Report](https://www.mozilla.org/about/governance/policies/participation/reporting/)' page.
 
 <!--
diff --git a/README.md b/README.md
index fc4890a..671f552 100644
--- a/README.md
+++ b/README.md
@@ -12,27 +12,9 @@ Linux, macOS and Windows are supported.
 
 This is a project initiated by Mozilla to gather code coverage results on Firefox.
 
-## Table of Contents
-
-* [man grcov](#man-grcov)
-* [How to get grcov](#how-to-get-grcov)
-* [Usage](#usage)
-  * [Example: How to generate source-based coverage for a Rust project](#example-how-to-generate-source-based-coverage-for-a-rust-project)
-  * [Example: How to generate .gcda files for C/C++](#example-how-to-generate-gcda-files-for-cc)
-  * [Example: How to generate .gcda files for a Rust project](#example-how-to-generate-gcda-files-for-a-rust-project)
-  * [Generate a coverage report from coverage artifacts](#generate-a-coverage-report-from-coverage-artifacts)
-    * [LCOV output](#lcov-output)
-    * [Coveralls/Codecov output](#coverallscodecov-output)
-    * [grcov with Travis](#grcov-with-travis)
-  * [Alternative reports](#alternative-reports)
-* [Auto-formatting](#auto-formatting)
-* [Build & Test](#build--test)
-* [Minimum requirements](#minimum-requirements)
-* [License](#license)
-
 ## man grcov
 
-```
+```text
 USAGE:
     grcov [FLAGS] [OPTIONS] <paths>...
 
@@ -146,7 +128,6 @@ ARGS:
             Sets the input paths to use
 ```
 
-
 ## How to get grcov
 
 Grcov can be downloaded from [releases](https://github.com/mozilla/grcov/releases) or, if you have Rust installed,
@@ -160,27 +141,30 @@ RUSTC_BOOTSTRAP=1`, which basically turns your stable rustc into a Nightly one.
 ### Example: How to generate source-based coverage for a Rust project
 
 1. Install the llvm-tools or llvm-tools-preview component:
-```sh
-rustup component add llvm-tools-preview
-```
+
+   ```sh
+   rustup component add llvm-tools-preview
+   ```
 
 2. Ensure that the following environment variable is set up:
-```sh
-export RUSTFLAGS="-Zinstrument-coverage"
-```
+
+   ```sh
+   export RUSTFLAGS="-Zinstrument-coverage"
+   ```
 
 3. Build your code:
 
-`cargo build`
+   `cargo build`
 
 4. Ensure each test runs gets its own profile information by defining the LLVM_PROFILE_FILE environment variable (%p will be replaced by the process ID, and %m by the binary signature):
-```sh
-export LLVM_PROFILE_FILE="your_name-%p-%m.profraw"
-```
+
+   ```sh
+   export LLVM_PROFILE_FILE="your_name-%p-%m.profraw"
+   ```
 
 5. Run your tests:
 
-`cargo test`
+   `cargo test`
 
 In the CWD, you will see a `.profraw` file has been generated. This contains the profiling information that grcov will parse, alongside with your binaries.
 
@@ -192,25 +176,25 @@ Pass `--coverage` to `clang` or `gcc` (or for older gcc versions pass `-ftest-co
 
 1. Ensure that the following environment variables are set up:
 
-```sh
-export CARGO_INCREMENTAL=0
-export RUSTFLAGS="-Zprofile -Ccodegen-units=1 -Copt-level=0 -Clink-dead-code -Coverflow-checks=off -Zpanic_abort_tests -Cpanic=abort"
-export RUSTDOCFLAGS="-Cpanic=abort"
-```
+   ```sh
+   export CARGO_INCREMENTAL=0
+   export RUSTFLAGS="-Zprofile -Ccodegen-units=1 -Copt-level=0 -Clink-dead-code -Coverflow-checks=off -Zpanic_abort_tests -Cpanic=abort"
+   export RUSTDOCFLAGS="-Cpanic=abort"
+   ```
 
-These will ensure that things like dead code elimination do not skew the coverage.
+   These will ensure that things like dead code elimination do not skew the coverage.
 
 2. Build your code:
 
-`cargo build`
+   `cargo build`
 
-If you look in `target/debug/deps` dir you will see `.gcno` files have appeared. These are the locations that could be covered.
+   If you look in `target/debug/deps` dir you will see `.gcno` files have appeared. These are the locations that could be covered.
 
 3. Run your tests:
 
-`cargo test`
+   `cargo test`
 
-In the `target/debug/deps/` dir you will now also see `.gcda` files. These contain the hit counts on which of those locations have been reached. Both sets of files are used as inputs to `grcov`.
+   In the `target/debug/deps/` dir you will now also see `.gcda` files. These contain the hit counts on which of those locations have been reached. Both sets of files are used as inputs to `grcov`.
 
 ### Generate a coverage report from coverage artifacts
 
@@ -245,7 +229,8 @@ grcov . --binary-path ./target/debug/ -t coveralls -s . --token YOUR_COVERALLS_T
 #### grcov with Travis
 
 Here is an example of .travis.yml file for source-based coverage:
-```YAML
+
+```yaml
 language: rust
 
 before_install:
@@ -266,7 +251,8 @@ script:
 ```
 
 Here is an example of .travis.yml file:
-```YAML
+
+```yaml
 language: rust
 
 before_install:
@@ -293,15 +279,15 @@ script:
 
 grcov provides the following output types:
 
-| Output Type `-t` | Description |
-| ---            | ---         |
-| lcov (default) | lcov's INFO format that is compatible with the linux coverage project. |
-| ade            | ActiveData\-ETL format. Only useful for Mozilla projects. |
-| coveralls      | Generates coverage in Coveralls format. |
-| coveralls+     | Like coveralls but with function level information. |
-| files          | Output a file list of covered or uncovered source files. |
-| covdir         | Provides coverage in a recursive JSON format. |
-| html           | Output a HTML coverage report, including coverage badges for your README. |
+| Output Type `-t` | Description                                                               |
+| ---------------- | ------------------------------------------------------------------------- |
+| lcov (default)   | lcov's INFO format that is compatible with the linux coverage project.    |
+| ade              | ActiveData\-ETL format. Only useful for Mozilla projects.                 |
+| coveralls        | Generates coverage in Coveralls format.                                   |
+| coveralls+       | Like coveralls but with function level information.                       |
+| files            | Output a file list of covered or uncovered source files.                  |
+| covdir           | Provides coverage in a recursive JSON format.                             |
+| html             | Output a HTML coverage report, including coverage badges for your README. |
 
 ### Hosting HTML reports and using coverage badges
 
@@ -365,13 +351,14 @@ docker build -t marcocas/grcov -f tests/Dockerfile .
 ```
 
 Otherwise, if you don't want to use Docker, the only prerequisite is to install GCC 7, setting the `GCC_CXX` environment variable to `g++-7` and the `GCOV` environment variable to `gcov-7`. Then run the tests with:
-```
+
+```sh
 cargo test
 ```
 
 ## Minimum requirements
 
-* GCC 4.9 or higher is required (if parsing coverage artifacts generated by GCC).
+- GCC 4.9 or higher is required (if parsing coverage artifacts generated by GCC).
 
 ## License