Add rule MD059/descriptive-link-text "Link text should be descriptive" (fixes #681).

README.md

@@ -146,6 +146,7 @@ playground for learning and exploring.
 - **[MD055](doc/md055.md)** *table-pipe-style* - Table pipe style
 - **[MD056](doc/md056.md)** *table-column-count* - Table column count
 - **[MD058](doc/md058.md)** *blanks-around-tables* - Tables should be surrounded by blank lines
+- **[MD059](doc/md059.md)** *descriptive-link-text* - Link text should be descriptive
 
 <!-- markdownlint-restore -->
 
@@ -165,7 +166,7 @@ To implement your own rules, refer to [CustomRules.md](doc/CustomRules.md).
 Tags group related rules and can be used to enable/disable multiple
 rules at once.
 
-- **`accessibility`** - `MD045`
+- **`accessibility`** - `MD045`, `MD059`
 - **`atx`** - `MD018`, `MD019`
 - **`atx_closed`** - `MD020`, `MD021`
 - **`blank_lines`** - `MD012`, `MD022`, `MD031`, `MD032`, `MD047`
@@ -183,7 +184,7 @@ rules at once.
 - **`language`** - `MD040`
 - **`line_length`** - `MD013`
 - **`links`** - `MD011`, `MD034`, `MD039`, `MD042`, `MD051`, `MD052`, `MD053`,
-  `MD054`
+  `MD054`, `MD059`
 - **`ol`** - `MD029`, `MD030`, `MD032`
 - **`spaces`** - `MD018`, `MD019`, `MD020`, `MD021`, `MD023`
 - **`spelling`** - `MD044`

doc-build/md059.md

@@ -0,0 +1,16 @@
+This rule is triggered when a link is set with generic text like
+"Click here", "here", or "learn more", giving it a generic accessible name.
+
+Rationale: Screen reader users may navigate through a list of links
+to quickly find content on a page. When the link name is something ambiguous
+like "Learn more", there isn't sufficient context to help the user determine
+whether to follow the link.
+
+Link names should be descriptive and describe the purpose of the link, like:
+`[Download the budget document]`, `[About markdownlint]`,`[View registration]`,
+etc.
+
+To override the default list and configure your own list of banned accessible
+names, set `link_texts` in the config.
+
+Note: This rule checks Markdown-style links and ignores HTML-style links.

doc/Rules.md

@@ -2538,6 +2538,35 @@ Some text
 Rationale: In addition to aesthetic reasons, some parsers will incorrectly parse
 tables that don't have blank lines before and after them.
 
+<a name="md059"></a>
+
+## `MD059` - Link text should be descriptive
+
+Tags: `accessibility`, `links`
+
+Aliases: `descriptive-link-text`
+
+Parameters:
+
+- `link_texts`: List of restricted link texts (`string[]`, default `[]`)
+
+This rule is triggered when a link is set with generic text like
+"Click here", "here", or "learn more", giving it a generic accessible name.
+
+Rationale: Screen reader users may navigate through a list of links
+to quickly find content on a page. When the link name is something ambiguous
+like "Learn more", there isn't sufficient context to help the user determine
+whether to follow the link.
+
+Link names should be descriptive and describe the purpose of the link, like:
+`[Download the budget document]`, `[About markdownlint]`,`[View registration]`,
+etc.
+
+To override the default list and configure your own list of banned accessible
+names, set `link_texts` in the config.
+
+Note: This rule checks Markdown-style links and ignores HTML-style links.
+
 <!-- markdownlint-configure-file {
   "no-inline-html": {
     "allowed_elements": [

doc/md059.md

@@ -0,0 +1,26 @@
+# `MD059` - Link text should be descriptive
+
+Tags: `accessibility`, `links`
+
+Aliases: `descriptive-link-text`
+
+Parameters:
+
+- `link_texts`: List of restricted link texts (`string[]`, default `[]`)
+
+This rule is triggered when a link is set with generic text like
+"Click here", "here", or "learn more", giving it a generic accessible name.
+
+Rationale: Screen reader users may navigate through a list of links
+to quickly find content on a page. When the link name is something ambiguous
+like "Learn more", there isn't sufficient context to help the user determine
+whether to follow the link.
+
+Link names should be descriptive and describe the purpose of the link, like:
+`[Download the budget document]`, `[About markdownlint]`,`[View registration]`,
+etc.
+
+To override the default list and configure your own list of banned accessible
+names, set `link_texts` in the config.
+
+Note: This rule checks Markdown-style links and ignores HTML-style links.

lib/configuration-strict.d.ts

@@ -1100,6 +1100,28 @@ export interface ConfigurationStrict {
    * MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md058.md
    */
   "blanks-around-tables"?: boolean;
+  /**
+   * MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+   */
+  MD059?:
+    | boolean
+    | {
+        /**
+         * List of restricted link texts
+         */
+        link_texts?: string[];
+      };
+  /**
+   * MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+   */
+  "descriptive-link-text"?:
+    | boolean
+    | {
+        /**
+         * List of restricted link texts
+         */
+        link_texts?: string[];
+      };
   /**
    * headings : MD001, MD003, MD018, MD019, MD020, MD021, MD022, MD023, MD024, MD025, MD026, MD036, MD041, MD043
    */
@@ -1125,7 +1147,7 @@ export interface ConfigurationStrict {
    */
   hard_tab?: boolean;
   /**
-   * links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054
+   * links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054, MD059
    */
   links?: boolean;
   /**
@@ -1185,7 +1207,7 @@ export interface ConfigurationStrict {
    */
   spelling?: boolean;
   /**
-   * accessibility : MD045
+   * accessibility : MD045, MD059
    */
   accessibility?: boolean;
   /**

lib/md059.mjs

@@ -0,0 +1,60 @@
+// @ts-check
+
+import { addErrorContext } from "../helpers/helpers.cjs";
+import { filterByTypesCached } from "./cache.mjs";
+
+const defaultBannedText = [
+  "click here",
+  "here",
+  "learn more",
+  "link",
+  "more",
+  "read more"
+];
+
+/**
+ * Normalizes a string and removes extra whitespaces and punctuations.
+ *
+ * @param {string} text String to transform.
+ * @returns {string} Normalized string with no punctuations or extra whitespaces.
+ */
+function normalizeText(text) {
+  return text
+    .toLowerCase()
+    .replace(/\W+/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+/** @type {import("markdownlint").Rule} */
+export default {
+  "names": [ "MD059", "descriptive-link-text" ],
+  "description": "Link text should be descriptive",
+  "tags": [ "links", "accessibility" ],
+  "parser": "micromark",
+  "function": function MD059(params, onError) {
+    const bannedNames = new Set(params.config.link_texts || defaultBannedText);
+    const labels = filterByTypesCached([ "label" ])
+      .filter((label) => label.parent?.type === "link");
+
+    for (const label of labels) {
+      const labelTexts = label.children.filter((child) => child.type === "labelText");
+      for (const labelText of labelTexts) {
+        const { text } = label;
+        if (bannedNames.has(normalizeText(text))) {
+          const range = labelText.startLine === labelText.endLine ?
+            [ labelText.startColumn, text.length ] :
+            undefined;
+          addErrorContext(
+            onError,
+            labelText.startLine,
+            text,
+            undefined,
+            undefined,
+            range
+          );
+        }
+      }
+    }
+  }
+};

lib/rules.mjs

@@ -53,6 +53,7 @@ import md054 from "./md054.mjs";
 import md055 from "./md055.mjs";
 import md056 from "./md056.mjs";
 import md058 from "./md058.mjs";
+import md059 from "./md059.mjs";
 
 const rules = [
   md001,
@@ -108,7 +109,8 @@ const rules = [
   md055,
   md056,
   // md057: See https://github.com/markdownlint/markdownlint
-  md058
+  md058,
+  md059
 ];
 for (const rule of rules) {
   const name = rule.names[0].toLowerCase();

schema/.markdownlint.jsonc

@@ -306,5 +306,11 @@
   "MD056": true,
 
   // MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md058.md
-  "MD058": true
+  "MD058": true,
+
+  // MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+  "MD059": {
+    // List of restricted link texts
+    "link_texts": []
+  }
 }

schema/.markdownlint.yaml

@@ -275,3 +275,8 @@ MD056: true
 
 # MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md058.md
 MD058: true
+
+# MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+MD059:
+  # List of restricted link texts
+  link_texts: []

schema/build-config-schema.mjs

@@ -556,6 +556,18 @@ for (const rule of rules) {
         }
       };
       break;
+    case "MD059":
+      scheme.properties = {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      };
+      break;
     default:
       custom = false;
       break;

schema/markdownlint-config-schema-strict.json

@@ -1716,6 +1716,44 @@
       "type": "boolean",
       "default": true
     },
+    "MD059": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
+    "descriptive-link-text": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
     "headings": {
       "description": "headings : MD001, MD003, MD018, MD019, MD020, MD021, MD022, MD023, MD024, MD025, MD026, MD036, MD041, MD043",
       "type": "boolean",
@@ -1747,7 +1785,7 @@
       "default": true
     },
     "links": {
-      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054",
+      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054, MD059",
       "type": "boolean",
       "default": true
     },
@@ -1822,7 +1860,7 @@
       "default": true
     },
     "accessibility": {
-      "description": "accessibility : MD045",
+      "description": "accessibility : MD045, MD059",
       "type": "boolean",
       "default": true
     },

schema/markdownlint-config-schema.json

@@ -1716,6 +1716,44 @@
       "type": "boolean",
       "default": true
     },
+    "MD059": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
+    "descriptive-link-text": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
     "headings": {
       "description": "headings : MD001, MD003, MD018, MD019, MD020, MD021, MD022, MD023, MD024, MD025, MD026, MD036, MD041, MD043",
       "type": "boolean",
@@ -1747,7 +1785,7 @@
       "default": true
     },
     "links": {
-      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054",
+      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054, MD059",
       "type": "boolean",
       "default": true
     },
@@ -1822,7 +1860,7 @@
       "default": true
     },
     "accessibility": {
-      "description": "accessibility : MD045",
+      "description": "accessibility : MD045, MD059",
       "type": "boolean",
       "default": true
     },

test/bare-urls.md

@@ -12,7 +12,7 @@ Visit https://example.com, then refresh. {MD034}
 
 The site (https://example.com) is down. {MD034}
 
-<!-- markdownlint-disable line-length no-inline-html -->
+<!-- markdownlint-disable descriptive-link-text line-length no-inline-html -->
 
 Some documents use <a href="https://example.com">to link</a>.
 

test/descriptive-link-text-empty-config.md

@@ -0,0 +1,35 @@
+# Descriptive link text empty config
+
+[Learn about Javascript](https://example.com/javascript/about)
+
+[About Javascript](https://example.com/file.txt)
+
+Learn about [our mission](https://example.com/mission).
+
+Go [here](https://example.com/descriptive-links)
+
+[Learn more](https://example.com/images/about) about us.
+
+[Click here](https://example.com/dir/file.txt).
+
+[read more](https://example.com/guide).
+
+To get more support, go [here!](https://example.com/contact).
+
+Learn [more.](https://example.com/contact).
+
+To learn about our company, [click here!!!!](https://example.com/about).
+
+[click-here!!!!](https://example.com/first).
+
+Go to this [link]((https://example.com/second)).
+
+[link][url]
+
+[url]: https://example.com
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": {
+    "link_texts": []
+  }
+} -->

test/descriptive-link-text-override.md

@@ -0,0 +1,23 @@
+# Descriptive link text override
+
+[Go here](https://example.com/javascript/about) {MD059}
+
+[Learn more](https://example.com/javascript/about).
+
+[Click here](https://example.com/javascript/about).
+
+To learn more, go [here!](https://example.com/site).
+
+To learn more, go to this [link!](https://example.com/links).
+
+If you need additional guidance, read [this](https://example.com/links). {MD059}
+
+[link][url]
+
+[url]: https://example.com
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": {
+    "link_texts": ["go here", "this"]
+  }
+} -->

test/descriptive-link-text.md

@@ -0,0 +1,32 @@
+# Descriptive link text
+
+[Learn about Javascript](https://example.com/javascript/about)
+
+[About Javascript](https://example.com/file.txt)
+
+Learn about [our mission](https://example.com/mission).
+
+Go [here](https://example.com/descriptive-links) {MD059}
+
+[Learn more](https://example.com/images/about) about us. {MD059}
+
+[Click here](https://example.com/dir/file.txt). {MD059}
+
+[read more](https://example.com/guide). {MD059}
+
+To get more support, go [here!](https://example.com/contact). {MD059}
+
+Learn [more](https://example.com/contact). {MD059}
+
+To learn more, [click here!!!!](https://example.com/about). {MD059}
+
+[click-here!!!!](https://example.com/first). {MD059}
+
+Go to this [link]((https://example.com/second)). {MD059}
+
+[link][Example URL] {MD059}
+
+[Example URL]: https://example.com
+
+{MD059} [click
+here](https://example.com)

test/fixing-with-front-matter.md

@@ -5,7 +5,7 @@ ignore: this
 # Fixing with Front Matter {MD022}
 Text text text {MD009}   
 
-Text [ link ](url) text {MD039}
+Text [ link ](url) text {MD039} {MD059}
 ## Nested Heading {MD022}
 
 Text {MD047}

test/link-style-no-url-inline-not-possible.md

@@ -60,6 +60,7 @@ Text [email] text
 [email]: user@example.com
 
 <!-- markdownlint-configure-file {
+  "descriptive-link-text": false,
   "link-image-style": {
     "autolink": false,
     "url_inline": false

test/link-style-no-url-inline-possible.md

@@ -61,6 +61,7 @@ Text [email] text
 [email]: user@example.com
 
 <!-- markdownlint-configure-file {
+  "descriptive-link-text": false,
   "link-image-style": {
     "url_inline": false
   }

test/links-alternate.md

@@ -45,5 +45,6 @@ Text [ link ][reference] text. {MD039}
 
 <!-- markdownlint-configure-file {
   "line-length": false,
-  "code-block-style": false
+  "code-block-style": false,
+  "descriptive-link-text": false
 } -->

test/long-lines-long-reference-definitions-stern.md

@@ -17,6 +17,7 @@
 [long-reference-definition]: https://example.com/long/long/long/long/long/long/long/long/long/long/long/long/long
 
 <!-- markdownlint-configure-file {
+  "descriptive-link-text": false,
   "line-length": {
     "stern": true
   }

test/long-lines-long-reference-definitions-strict.md

@@ -19,5 +19,6 @@
 <!-- markdownlint-configure-file {
   "line-length": {
     "strict": true
-  }
+  },
+  "descriptive-link-text": false
 } -->

test/long-lines-long-reference-definitions.md

@@ -15,3 +15,5 @@
 [long-reference-definition-image]: https://example.com/long/long/long/long/long/long/long/long/long/long/long/long/long/image
 <!-- markdownlint-disable-next-line link-image-reference-definitions -->
 [long-reference-definition]: https://example.com/long/long/long/long/long/long/long/long/long/long/long/long/long
+
+<!-- markdownlint-disable-file descriptive-link-text -->

test/markdown-in-html.md

@@ -34,4 +34,4 @@ Text
 
 </p>
 
-<!-- markdownlint-disable-file line-length no-inline-html -->
+<!-- markdownlint-disable-file descriptive-link-text line-length no-inline-html -->

test/markdownlint-test.mjs

@@ -832,7 +832,7 @@ test("customFileSystemAsync", (t) => new Promise((resolve) => {
 }));
 
 test("readme", async(t) => {
-  t.plan(128);
+  t.plan(130);
   const tagToRules = {};
   for (const rule of rules) {
     for (const tag of rule.tags) {
@@ -907,7 +907,7 @@ test("readme", async(t) => {
 });
 
 test("validateJsonUsingConfigSchemaStrict", async(t) => {
-  t.plan(182);
+  t.plan(187);
   // @ts-ignore
   const ajv = new Ajv(ajvOptions);
   const validateSchemaStrict = ajv.compile(configSchemaStrict);
@@ -1029,7 +1029,7 @@ test("validateConfigExampleJson", (t) => {
 });
 
 test("allBuiltInRulesHaveValidUrl", (t) => {
-  t.plan(153);
+  t.plan(156);
   for (const rule of rules) {
     // @ts-ignore
     t.truthy(rule.information);

test/reversed_link.md

@@ -87,5 +87,6 @@ Text (text()[text] text
 <!-- markdownlint-configure-file {
   "code-block-style": false,
   "line-length": false,
-  "no-inline-html": false
+  "no-inline-html": false,
+  "descriptive-link-text": false
 } -->

test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.md

@@ -16,4 +16,33 @@ Generated by [AVA](https://avajs.dev).
     test-repos/dotnet-docs/SECURITY.md: 25: MD007/ul-indent Unordered list indentation [Expected: 0; Actual: 2]␊
     test-repos/dotnet-docs/SECURITY.md: 26: MD007/ul-indent Unordered list indentation [Expected: 0; Actual: 2]␊
     test-repos/dotnet-docs/SECURITY.md: 27: MD007/ul-indent Unordered list indentation [Expected: 0; Actual: 2]␊
-    test-repos/dotnet-docs/SECURITY.md: 17: MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]`
+    test-repos/dotnet-docs/SECURITY.md: 17: MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]␊
+    test-repos/dotnet-docs/docs/architecture/blazor-for-web-forms-developers/security-authentication-authorization.md: 258: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/architecture/cloud-native/deploy-eshoponcontainers-azure.md: 60: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/core/diagnostics/built-in-metrics-aspnetcore.md: 12: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/core/testing/unit-testing-code-coverage.md: 274: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/core/testing/unit-testing-platform-architecture-extensions.md: 501: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/csharp/delegate-class.md: 41: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/csharp/whats-new/breaking-changes.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/framework/windows-workflow-foundation/samples/sql-tracking.md: 42: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fsharp/language-reference/computation-expressions.md: 277: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/code-analysis/quality-rules/ca1066.md: 28: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/code-analysis/quality-rules/ca1067.md: 28: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/networking/http/httpclient-migrate-from-httpwebrequest.md: 340: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/networking/http/httpclient-migrate-from-httpwebrequest.md: 580: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/deployment/consul-deployment.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/index.md: 107: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/streams-programming-apis.md: 14: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/streams-programming-apis.md: 321: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/streams-why.md: 68: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/tutorials-and-samples/overview-helloworld.md: 17: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/standard/native-interop/tutorial-comwrappers.md: 251: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/core-changes/aspnetcore/3.0/authn-apis-json-types.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/core-changes/aspnetcore/3.0/authn-google-plus-authn-changes.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/core-changes/aspnetcore/3.0/kestrel-connection-adapters-removed.md: 25: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/networking/only-tls-10-11-12-protocols-supported-systemnetservicepointmanager.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/security/cspparametersparentwindowhandle-now-expects-hwnd-value.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/wf/workflow-30-types-are-obsolete.md: 9: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/wf/workflow-30-types-are-obsolete.md: 9: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/runtime/runtime/improved-wcf-chain-trust-certificate-validation-for-nettcp-authentication.md: 5: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/samples/snippets/core/tutorials/netcore-hosting/csharp/HostWithHostFxr/readme.md: 3: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`

test/snapshots/markdownlint-test-repos-mdn-content.mjs.md

@@ -8,4 +8,67 @@ Generated by [AVA](https://avajs.dev).
 
 > Expected linting violations
 
-    ''
+    `test-repos/mdn-content/files/en-us/glossary/media_query/index.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/css_layout/fundamental_layout_comprehension/index.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/scripting/functions/index.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/structuring_content/creating_links/index.md: 255: MD059/descriptive-link-text Link text should be descriptive [Context: "[Click here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/styling_basics/box_model/index.md: 293: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/performance/css/index.md: 174: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/performance/multimedia/index.md: 105: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/django/development_environment/index.md: 225: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/django/development_environment/index.md: 464: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/django/models/index.md: 491: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/express_nodejs/deployment/index.md: 379: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/howto/tools_and_setup/how_much_does_it_cost/index.md: 81: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/howto/tools_and_setup/how_much_does_it_cost/index.md: 81: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/howto/web_mechanics/what_is_a_domain_name/index.md: 175: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/document_an_http_header/index.md: 21: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/json_structured_data/index.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/json_structured_data/index.md: 123: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/json_structured_data/index.md: 132: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md: 458: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/add-ons/webextensions/native_messaging/index.md: 399: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/17/index.md: 39: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/22/index.md: 57: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/29/index.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/3/updating_extensions/index.md: 162: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/44/index.md: 218: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/aria_techniques/index.md: 18: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/attributes/aria-disabled/index.md: 115: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/attributes/aria-expanded/index.md: 99: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/attributes/aria-haspopup/index.md: 65: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/roles/command_role/index.md: 17: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/roles/index.md: 88: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
+    test-repos/mdn-content/files/en-us/web/api/background_fetch_api/index.md: 89: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/filesystem/index.md: 12: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/html_drag_and_drop_api/index.md: 243: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/htmlanchorelement/index.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/htmllinkelement/as/index.md: 17: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/htmllinkelement/index.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/media_source_extensions_api/transcoding_assets_for_mse/index.md: 28: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/stylesheet/ownernode/index.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/svgaelement/target/index.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/webglrenderingcontext/getextension/index.md: 46: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/webglrenderingcontext/getsupportedextensions/index.md: 44: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/css/_colon_any-link/index.md: 66: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`:link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/_colon_visited/index.md: 14: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`:link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/_colon_visited/index.md: 24: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/css_media_queries/index.md: 131: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/css_media_queries/index.md: 132: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/justify-items/index.md: 18: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/mdn-content/files/en-us/web/css/justify-items/index.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/mdn-content/files/en-us/web/css/justify-items/index.md: 20: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/mdn-content/files/en-us/web/html/attributes/rel/preconnect/index.md: 22: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/mdn-content/files/en-us/web/html/attributes/rel/preload/index.md: 105: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 54: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 92: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/javascript/guide/modules/index.md: 407: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/performance/dns-prefetch/index.md: 74: MD059/descriptive-link-text Link text should be descriptive [Context: "[\\<link>]"]␊
+    test-repos/mdn-content/files/en-us/web/performance/speculative_loading/index.md: 50: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/mdn-content/files/en-us/web/performance/speculative_loading/index.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/mdn-content/files/en-us/web/svg/tutorial/getting_started/index.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/uri/schemes/data/index.md: 27: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/uri/schemes/data/index.md: 27: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/xml/xpath/guides/introduction_to_using_xpath_in_javascript/index.md: 42: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`

test/snapshots/markdownlint-test-repos-small.mjs.md

@@ -159,19 +159,56 @@ Generated by [AVA](https://avajs.dev).
     test-repos/apache-airflow/clients/python/README.md: 395: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing leading pipe]␊
     test-repos/apache-airflow/clients/python/README.md: 395: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing trailing pipe]␊
     test-repos/apache-airflow/clients/python/README.md: 396: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing leading pipe]␊
-    test-repos/apache-airflow/clients/python/README.md: 396: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing trailing pipe]`
+    test-repos/apache-airflow/clients/python/README.md: 396: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing trailing pipe]␊
+    test-repos/apache-airflow/dev/MANUALLY_BUILDING_IMAGES.md: 49: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/apache-airflow/dev/MANUALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md: 118: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/apache-airflow/dev/PROJECT_GUIDELINES.md: 42: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/apache-airflow/generated/README.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/apache-airflow/providers/google/tests/system/google/README.md: 77: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`
 
 ## https://github.com/electron/electron
 
 > Expected linting violations
 
-    ''
+    `test-repos/electron-electron/CONTRIBUTING.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/app.md: 687: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/app.md: 689: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/session.md: 838: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/printer-info.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/printer-info.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/web-preferences.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/web-preferences.md: 24: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/web-contents.md: 132: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1147: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1705: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1726: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1830: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1978: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 30: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 58: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 58: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 58: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/creating-api.md: 47: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/creating-api.md: 161: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/pull-requests.md: 183: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/electron-timelines.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/fuses.md: 141: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/launch-app-from-url-in-another-app.md: 66: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/mac-app-store-submission-guide.md: 63: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/snapcraft.md: 24: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/tray.md: 67: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/windows-store-guide.md: 104: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/windows-store-guide.md: 107: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/windows-store-guide.md: 137: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`
 
 ## https://github.com/eslint/eslint
 
 > Expected linting violations
 
-    ''
+    `test-repos/eslint-eslint/docs/src/extend/custom-rule-tutorial.md: 494: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/eslint-eslint/docs/src/extend/custom-rules.md: 141: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/eslint-eslint/docs/src/extend/custom-rules.md: 148: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/eslint-eslint/docs/src/integrate/integration-tutorial.md: 278: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`
 
 ## https://github.com/mkdocs/mkdocs
 
@@ -188,6 +225,7 @@ Generated by [AVA](https://avajs.dev).
     test-repos/mochajs-mocha/PROJECT_CHARTER.md: 51: MD051/link-fragments Link fragments should be valid [Context: "[§2: Scope](#%c2%a72-scope)"]␊
     test-repos/mochajs-mocha/PROJECT_CHARTER.md: 56: MD051/link-fragments Link fragments should be valid [Context: "[§2: Scope](#%c2%a72-scope)"]␊
     test-repos/mochajs-mocha/README.md: 39: MD045/no-alt-text Images should have alternate text (alt text)␊
+    test-repos/mochajs-mocha/docs/changelogs/CHANGELOG_V3_older.md: 207: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
     test-repos/mochajs-mocha/docs/index.md: 32: MD051/link-fragments Link fragments should be valid [Context: "[global variable leak detection](#-check-leaks)"]␊
     test-repos/mochajs-mocha/docs/index.md: 33: MD051/link-fragments Link fragments should be valid [Context: "[optionally run tests that match a regexp](#-grep-regexp-g-regexp)"]␊
     test-repos/mochajs-mocha/docs/index.md: 34: MD051/link-fragments Link fragments should be valid [Context: "[auto-exit to prevent "hanging" with an active loop](#-exit)"]␊
@@ -212,22 +250,40 @@ Generated by [AVA](https://avajs.dev).
     test-repos/mochajs-mocha/docs/index.md: 2112: MD051/link-fragments Link fragments should be valid [Context: "[Watch mode](#-watch-w)"]␊
     test-repos/mochajs-mocha/docs/index.md: 2399: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "caniuse-notifications"] [Context: "[caniuse-notifications]: https..."]␊
     test-repos/mochajs-mocha/docs/index.md: 2400: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "caniuse-promises"] [Context: "[caniuse-promises]: https://ca..."]␊
-    test-repos/mochajs-mocha/docs/index.md: 2431: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "mocha-website"] [Context: "[mocha-website]: https://mocha..."]`
+    test-repos/mochajs-mocha/docs/index.md: 2431: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "mocha-website"] [Context: "[mocha-website]: https://mocha..."]␊
+    test-repos/mochajs-mocha/docs/index.md: 2200: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mochajs-mocha/docs/index.md: 2270: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`
 
 ## https://github.com/pi-hole/docs
 
 > Expected linting violations
 
-    ''
+    `test-repos/pi-hole-docs/docs/ftldns/configfile.md: 224: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/ftldns/configfile.md: 224: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/dns/upstream-dns-providers.md: 120: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/misc/benchmark.md: 32: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/vpn/openvpn/clients.md: 38: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/vpn/openvpn/dual-operation.md: 5: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/vpn/openvpn/firewall.md: 61: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/main/prerequisites.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`
 
 ## https://github.com/v8/v8.dev
 
 > Expected linting violations
 
-    `test-repos/v8-v8-dev/src/blog/fast-for-in.md: 271: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Internal method       | Hand..."]␊
+    `test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 75: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 77: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 89: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 232: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/fast-for-in.md: 271: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Internal method       | Hand..."]␊
     test-repos/v8-v8-dev/src/blog/fast-for-in.md: 277: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`[[OwnPropertyKeys]]\` | \`own..."]␊
     test-repos/v8-v8-dev/src/blog/fast-for-in.md: 351: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Position | Name             ..."]␊
     test-repos/v8-v8-dev/src/blog/fast-for-in.md: 369: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| 17       | \`ForInFilter\`    ..."]␊
+    test-repos/v8-v8-dev/src/blog/high-performance-cpp-gc.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 13: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 13: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 38: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
     test-repos/v8-v8-dev/src/blog/lazy-unlinking.md: 183: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Benchmark    | Kind         ..."]␊
     test-repos/v8-v8-dev/src/blog/lazy-unlinking.md: 188: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| youtube.com  | Average size ..."]␊
     test-repos/v8-v8-dev/src/blog/maglev.md: 143: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Benchmark   | Energy Consump..."]␊
@@ -275,6 +331,7 @@ Generated by [AVA](https://avajs.dev).
     test-repos/v8-v8-dev/src/blog/oilpan-pointer-compression.md: 139: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`\`\`                         ..."]␊
     test-repos/v8-v8-dev/src/blog/oilpan-pointer-compression.md: 185: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| C++                         ..."]␊
     test-repos/v8-v8-dev/src/blog/oilpan-pointer-compression.md: 202: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`\`\`                         ..."]␊
+    test-repos/v8-v8-dev/src/blog/optimizing-v8-memory.md: 35: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
     test-repos/v8-v8-dev/src/blog/pointer-compression.md: 192: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: leading_only; Missing trailing pipe]␊
     test-repos/v8-v8-dev/src/blog/pointer-compression.md: 193: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: leading_only; Missing trailing pipe]␊
     test-repos/v8-v8-dev/src/blog/pointer-compression.md: 194: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: leading_only; Missing trailing pipe]␊
@@ -307,20 +364,33 @@ Generated by [AVA](https://avajs.dev).
     test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 191: MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "> 7. Return \`NormalCompletion(..."]␊
     test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 113: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Name         | Description  ..."]␊
     test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 117: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`[[Target]]\` | Used for dire..."]␊
+    test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 102: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/v8-nodejs.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
     test-repos/v8-v8-dev/src/blog/v8-release-80.md: 46: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "|                       || Des..."]␊
     test-repos/v8-v8-dev/src/blog/v8-release-80.md: 53: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| ^^          | GC       | -7%..."]␊
+    test-repos/v8-v8-dev/src/blog/v8-release-86.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/wasm-decompile.md: 153: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/wasm-decompile.md: 153: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/wasm-decompile.md: 153: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
     test-repos/v8-v8-dev/src/docs/become-committer.md: 34: MD034/no-bare-urls Bare URL used [Context: "v8-committers@googlegroups.com"]␊
     test-repos/v8-v8-dev/src/docs/become-committer.md: 44: MD034/no-bare-urls Bare URL used [Context: "v8-committers@googlegroups.com"]␊
+    test-repos/v8-v8-dev/src/docs/blink-layout-tests.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/v8-v8-dev/src/docs/contribute.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/docs/cross-compile-arm.md: 21: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
     test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 41: MD034/no-bare-urls Bare URL used [Context: "v8-eng-review-owners@googlegro..."]␊
     test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 78: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
     test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 80: MD034/no-bare-urls Bare URL used [Context: "v8-eng-review-owners@googlegro..."]␊
+    test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 126: MD059/descriptive-link-text Link text should be descriptive [Context: "[Here]"]␊
     test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 7: MD034/no-bare-urls Bare URL used [Context: "syg@chromium.org"]␊
     test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 7: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
     test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 9: MD034/no-bare-urls Bare URL used [Context: "gdeepti@chromium.org"]␊
     test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 9: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
+    test-repos/v8-v8-dev/src/docs/hidden-classes.md: 133: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
     test-repos/v8-v8-dev/src/docs/official-support.md: 19: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
     test-repos/v8-v8-dev/src/docs/respectful-code.md: 36: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Term      | Suggested altern..."]␊
     test-repos/v8-v8-dev/src/docs/respectful-code.md: 45: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| redline   | priority line, l..."]␊
+    test-repos/v8-v8-dev/src/docs/torque.md: 527: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/docs/trace.md: 5: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
     test-repos/v8-v8-dev/src/feature-support.md: 11: MD033/no-inline-html Inline HTML [Element: feature-support]␊
     test-repos/v8-v8-dev/src/feature-support.md: 19: MD033/no-inline-html Inline HTML [Element: feature-support]␊
     test-repos/v8-v8-dev/src/feature-support.md: 27: MD033/no-inline-html Inline HTML [Element: feature-support]␊
@@ -378,6 +448,7 @@ Generated by [AVA](https://avajs.dev).
     test-repos/v8-v8-dev/src/features/promise-finally.md: 82: MD033/no-inline-html Inline HTML [Element: feature-support]␊
     test-repos/v8-v8-dev/src/features/regexp-match-indices.md: 134: MD033/no-inline-html Inline HTML [Element: feature-support]␊
     test-repos/v8-v8-dev/src/features/regexp-v-flag.md: 254: MD033/no-inline-html Inline HTML [Element: feature-support]␊
+    test-repos/v8-v8-dev/src/features/simd.md: 217: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
     test-repos/v8-v8-dev/src/features/stable-sort.md: 76: MD033/no-inline-html Inline HTML [Element: feature-support]␊
     test-repos/v8-v8-dev/src/features/stable-sort.md: 84: MD033/no-inline-html Inline HTML [Element: feature-support]␊
     test-repos/v8-v8-dev/src/features/string-matchall.md: 92: MD033/no-inline-html Inline HTML [Element: feature-support]␊
@@ -426,6 +497,7 @@ Generated by [AVA](https://avajs.dev).
     test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/local-server.md: 63: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "webhint repo"] [Context: "[webhint repo]: https://github..."]␊
     test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/local-server.md: 64: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "webhint.io"] [Context: "[webhint.io]: https://webhint...."]␊
     test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/local-server.md: 65: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "webhintio repo"] [Context: "[webhintio repo]: https://gith..."]␊
+    test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/travis-and-azure.md: 4: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
     test-repos/webhintio-hint/packages/hint/docs/user-guide/index.md: 178: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "nodejsdownloadcurrent"] [Context: "[NodejsDownloadCurrent]: https..."]␊
     test-repos/webhintio-hint/packages/hint/docs/user-guide/troubleshoot/summary.md: 137: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "githubwebhintiohint308"] [Context: "[GithubWebhintioHint308]: http..."]␊
     test-repos/webhintio-hint/packages/hint/docs/user-guide/troubleshoot/summary.md: 141: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "npmjspackageiltorb"] [Context: "[NpmjsPackageIltorb]: https://..."]␊

test/spaces-inside-link-text.md

@@ -15,3 +15,7 @@
 [ link `link` ](https://example.com/) {MD039}
 
 [ *link* link ](https://example.com/) {MD039}
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": false
+} -->

test/spaces_inside_codespan_elements.md

@@ -70,6 +70,8 @@ text and ``\`code with ignored escaped \` backticks``
 
 `` ` leading and trailing space allowed for backtick ` `` text `code`
 
+<!-- markdownlint-disable descriptive-link-text -->
+
 Text [link](https://example.com/link`link) text `code`.
 
 Text [link](https://example.com/link```link) text ```code```.

test/spaces_inside_emphasis_markers.md

@@ -1,7 +1,5 @@
 # Heading
 
-<!-- markdownlint-disable-file emphasis-style strong-style -->
-
 Line with *Normal emphasis*
 
 Line with **Normal strong**
@@ -391,3 +389,9 @@ Emphasis <p data="* attribute *">* HTML *</p> {MD033} {MD037}
 
 Embedded underscore is okay:
 Text _emphas_i_s_ text _emphasis_
+
+<!-- markdownlint-configure-file {
+  "emphasis-style": false,
+  "descriptive-link-text": false,
+  "strong-style": false
+} -->

test/spaces_inside_link_text.md

@@ -105,3 +105,7 @@ Wrapped [
 Not a link, just [ text in ] brackets
 
 Images are ![ not links ](image.jpg)
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": false
+} -->

test/table-content-with-issues.md

@@ -1,13 +1,13 @@
 # Table Content With Issues
 
-| Content                      | Issue   |
+| Content                      | Issue           |
-|------------------------------|---------|
+|------------------------------|-----------------|
-| Text                         | N/A     |
+| Text                         | N/A             |
-| (link)[https://example.com]  | {MD011} |
+| (link)[https://example.com]  | {MD011}         |
-| <hr>                         | {MD033} |
+| <hr>                         | {MD033}         |
-| https://example.com          | {MD034} |
+| https://example.com          | {MD034}         |
-| * emphasis*                  | {MD037} |
+| * emphasis*                  | {MD037}         |
-| __strong __                  | {MD037} |
+| __strong __                  | {MD037}         |
-|  ` code`                     | {MD038} |
+|  ` code`                     | {MD038}         |
-| [link ](https://example.com) | {MD039} |
+| [link ](https://example.com) | {MD039} {MD059} |
-| [link]()                     | {MD042} |
+| [link]()                     | {MD042} {MD059} |

test/token-map-spans.md

@@ -38,5 +38,6 @@ code
 
 <!-- markdownlint-configure-file {
   "code-block-style": false,
-  "heading-style": false
+  "heading-style": false,
+  "descriptive-link-text": false
 } -->