diff --git a/README.md b/README.md index 8b0c90c9a..525cb4c40 100644 --- a/README.md +++ b/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 @@ -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` diff --git a/doc-build/md059.md b/doc-build/md059.md new file mode 100644 index 000000000..90caf326f --- /dev/null +++ b/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. diff --git a/doc/Rules.md b/doc/Rules.md index ded40d8aa..6e88351b5 100644 --- a/doc/Rules.md +++ b/doc/Rules.md @@ -2526,6 +2526,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. + + +## `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. + + Some documents use to link. diff --git a/test/descriptive-link-text-empty-config.md b/test/descriptive-link-text-empty-config.md new file mode 100644 index 000000000..2cfebd010 --- /dev/null +++ b/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 + + diff --git a/test/descriptive-link-text-override.md b/test/descriptive-link-text-override.md new file mode 100644 index 000000000..0fc80a1ca --- /dev/null +++ b/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 + + diff --git a/test/descriptive-link-text.md b/test/descriptive-link-text.md new file mode 100644 index 000000000..4701f1f31 --- /dev/null +++ b/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) diff --git a/test/fixing-with-front-matter.md b/test/fixing-with-front-matter.md index 231f1b4ed..25e439729 100644 --- a/test/fixing-with-front-matter.md +++ b/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} \ No newline at end of file diff --git a/test/link-style-no-url-inline-not-possible.md b/test/link-style-no-url-inline-not-possible.md index d5309360d..75d771f50 100644 --- a/test/link-style-no-url-inline-not-possible.md +++ b/test/link-style-no-url-inline-not-possible.md @@ -60,6 +60,7 @@ Text [email] text [email]: user@example.com diff --git a/test/long-lines-long-reference-definitions-stern.md b/test/long-lines-long-reference-definitions-stern.md index b2b2879cb..c12843d73 100644 --- a/test/long-lines-long-reference-definitions-stern.md +++ b/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 diff --git a/test/long-lines-long-reference-definitions.md b/test/long-lines-long-reference-definitions.md index 505b8cb95..d0d99988d 100644 --- a/test/long-lines-long-reference-definitions.md +++ b/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 [long-reference-definition]: https://example.com/long/long/long/long/long/long/long/long/long/long/long/long/long + + \ No newline at end of file diff --git a/test/markdown-in-html.md b/test/markdown-in-html.md index 4f3591d6b..ad8f9ad07 100644 --- a/test/markdown-in-html.md +++ b/test/markdown-in-html.md @@ -34,4 +34,4 @@ Text
- + diff --git a/test/markdownlint-test.mjs b/test/markdownlint-test.mjs index 01e6bdf2d..dba36b92c 100644 --- a/test/markdownlint-test.mjs +++ b/test/markdownlint-test.mjs @@ -88,7 +88,7 @@ test("projectFiles", (t) => { return import("globby") .then((module) => module.globby(projectFiles)) .then((files) => { - t.is(files.length, 60); + t.is(files.length, 61); const options = { files, "config": require("../.markdownlint.json") @@ -115,7 +115,7 @@ test("projectFilesExtendedAscii", (t) => { "!doc/md036.md" ])) .then((files) => { - t.is(files.length, 56); + t.is(files.length, 57); const options = { files, "config": require("../.markdownlint.json"), @@ -873,7 +873,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) { @@ -948,7 +948,7 @@ test("readme", async(t) => { }); test("validateJsonUsingConfigSchemaStrict", async(t) => { - t.plan(181); + t.plan(186); // @ts-ignore const ajv = new Ajv(ajvOptions); const validateSchemaStrict = ajv.compile(configSchemaStrict); @@ -1070,7 +1070,7 @@ test("validateConfigExampleJson", (t) => { }); test("allBuiltInRulesHaveValidUrl", (t) => { - t.plan(153); + t.plan(156); for (const rule of rules) { // @ts-ignore t.truthy(rule.information); diff --git a/test/reversed_link.md b/test/reversed_link.md index 495ba941b..dedd34b6e 100644 --- a/test/reversed_link.md +++ b/test/reversed_link.md @@ -87,5 +87,6 @@ Text (text()[text] text diff --git a/test/snapshots/markdownlint-test-custom-rules.mjs.snap b/test/snapshots/markdownlint-test-custom-rules.mjs.snap index 520c2decd..0e0f59473 100644 Binary files a/test/snapshots/markdownlint-test-custom-rules.mjs.snap and b/test/snapshots/markdownlint-test-custom-rules.mjs.snap differ diff --git a/test/snapshots/markdownlint-test-micromark.mjs.snap b/test/snapshots/markdownlint-test-micromark.mjs.snap index ff14778de..5c7e8b8d5 100644 Binary files a/test/snapshots/markdownlint-test-micromark.mjs.snap and b/test/snapshots/markdownlint-test-micromark.mjs.snap differ diff --git a/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.md b/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.md index 98553d4b6..0f05c648d 100644 --- a/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.md +++ b/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]"]` diff --git a/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.snap b/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.snap index d9a530547..d26a0edf9 100644 Binary files a/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.snap and b/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.snap differ diff --git a/test/snapshots/markdownlint-test-repos-mdn-content.mjs.md b/test/snapshots/markdownlint-test-repos-mdn-content.mjs.md index ce511ed6e..9fb8b65aa 100644 --- a/test/snapshots/markdownlint-test-repos-mdn-content.mjs.md +++ b/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: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + 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: 465: 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: 22: 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: "[\`\`]"]␊ + test-repos/mdn-content/files/en-us/web/api/htmllinkelement/as/index.md: 17: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`\`]"]␊ + test-repos/mdn-content/files/en-us/web/api/htmllinkelement/index.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + test-repos/mdn-content/files/en-us/web/css/css_media_queries/index.md: 129: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`\`]"]␊ + test-repos/mdn-content/files/en-us/web/css/css_media_queries/index.md: 130: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + 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: "[\`\`]"]␊ + test-repos/mdn-content/files/en-us/web/javascript/guide/modules/index.md: 408: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`\`]"]␊ + test-repos/mdn-content/files/en-us/web/performance/dns-prefetch/index.md: 74: MD059/descriptive-link-text Link text should be descriptive [Context: "[\\]"]␊ + 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/xpath/introduction_to_using_xpath_in_javascript/index.md: 43: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]` diff --git a/test/snapshots/markdownlint-test-repos-mdn-content.mjs.snap b/test/snapshots/markdownlint-test-repos-mdn-content.mjs.snap index 24d004236..607641154 100644 Binary files a/test/snapshots/markdownlint-test-repos-mdn-content.mjs.snap and b/test/snapshots/markdownlint-test-repos-mdn-content.mjs.snap differ diff --git a/test/snapshots/markdownlint-test-repos-small.mjs.md b/test/snapshots/markdownlint-test-repos-small.mjs.md index d2ec5a21f..982100184 100644 --- a/test/snapshots/markdownlint-test-repos-small.mjs.md +++ b/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/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: 1079: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊ + test-repos/electron-electron/docs/breaking-changes.md: 1637: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊ + test-repos/electron-electron/docs/breaking-changes.md: 1658: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊ + test-repos/electron-electron/docs/breaking-changes.md: 1762: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊ + test-repos/electron-electron/docs/breaking-changes.md: 1910: 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: 32: MD034/no-bare-urls Bare URL used [Context: "v8-committers@googlegroups.com"]␊ test-repos/v8-v8-dev/src/docs/become-committer.md: 42: 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://..."]␊ diff --git a/test/snapshots/markdownlint-test-repos-small.mjs.snap b/test/snapshots/markdownlint-test-repos-small.mjs.snap index d11cebcd4..e1370c3aa 100644 Binary files a/test/snapshots/markdownlint-test-repos-small.mjs.snap and b/test/snapshots/markdownlint-test-repos-small.mjs.snap differ diff --git a/test/snapshots/markdownlint-test-scenarios.mjs.md b/test/snapshots/markdownlint-test-scenarios.mjs.md index d4114d80b..8f948f232 100644 --- a/test/snapshots/markdownlint-test-scenarios.mjs.md +++ b/test/snapshots/markdownlint-test-scenarios.mjs.md @@ -3606,7 +3606,7 @@ Generated by [AVA](https://avajs.dev). ␊ The site (* HTML *
{MD033} {MD037} Embedded underscore is okay: Text _emphas_i_s_ text _emphasis_ + + diff --git a/test/spaces_inside_link_text.md b/test/spaces_inside_link_text.md index 0d7e7aace..41932da09 100644 --- a/test/spaces_inside_link_text.md +++ b/test/spaces_inside_link_text.md @@ -105,3 +105,7 @@ Wrapped [ Not a link, just [ text in ] brackets Images are ![ not links ](image.jpg) + + \ No newline at end of file diff --git a/test/table-content-with-issues.md b/test/table-content-with-issues.md index c1fbf0af5..ee2229eb0 100644 --- a/test/table-content-with-issues.md +++ b/test/table-content-with-issues.md @@ -1,13 +1,13 @@ # Table Content With Issues -| Content | Issue | -|------------------------------|---------| -| Text | N/A | -| (link)[https://example.com] | {MD011} | -|