Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Synchronize Markdownlint configuration with upstream #14214

Merged
merged 1 commit into from
Jul 14, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 64 additions & 17 deletions .markdownlint-cli2.jsonc
Original file line number Diff line number Diff line change
Expand Up @@ -14,12 +14,19 @@
"spaces_per_tab": 2
},
"MD013": false,
// Fixed upstream with "allow_different_nesting": true
"MD024": false,
// XXX Replace with the following when ready:
// "MD024": {
// "allow_different_nesting": true
// },
"MD025": {
"front_matter_title": "^\\s*title\\s*[:=]"
},
"MD026": false,
// XXX Replace with the following when ready:
// "MD026": {
// "punctuation": ".,;:"
// },
// Consecutive Notes/Callouts currently don't conform with this rule
"MD028": false,
// Force ordered numbering to catch accidental list ending from indenting
Expand Down Expand Up @@ -96,9 +103,9 @@
"tr",
"ul",
"var",
"ruby", //Used in some Korean documents
"rp", //Used in some Korean documents
"rt", //Used in some Korean documents
"ruby", // Used in some Korean documents
"rp", // Used in some Korean documents
"rt", // Used in some Korean documents
"i", // French translations use this for English literal text
"q", // French translations use this for English literal text
"h2", // Not always converted currently because of live samples using English IDs
Expand All @@ -107,20 +114,23 @@
]
},
"MD034": false,
// Fixed upstream, needs PRs in this repo
// XXX Fixed upstream, enable rule when fixed here
"MD036": false,
// Upstream fixing in https://github.com/mdn/content/pull/20115
// Produces too many false positives
"MD037": false,
"MD040": false,
// See https://github.com/mdn/content/pull/20026, as macros currently break this
"MD042": false,
// Tracked upstream as part of https://github.com/mdn/content/pull/19334
// XXX Fixed upstream, enable rule when fixed here
"MD045": false,
"MD046": {
"style": "fenced"
},
// MD049 is set to underscore upstream, not yet fixed here
"MD049": false,
// XXX Replace with the following when ready:
// "MD049": {
// "style": "underscore"
// },
"MD050": {
"style": "asterisk"
},
Expand All @@ -131,48 +141,85 @@
"MD052": false,
"search-replace": {
"rules": [
// XXX Many instances still found in translated content
// {
// "name": "curly-double-quotes",
// "message": "Don't use curly double quotes",
// "searchPattern": "/“|”/g",
// "replace": "\"",
// "searchScope": "text"
// },
// {
// "name": "curly-single-quotes",
// "message": "Don't use curly single quotes",
// "searchPattern": "/‘|’/g",
// "replace": "'",
// "searchScope": "text"
// },
{
"name": "nbsp",
"message": "Don't use no-break spaces",
"searchPattern": "/ /g",
"replace": " ",
"skipCode": false
"searchScope": "all"
},
// XXX Many instances still found in translated content
// {
// "name": "m-dash",
// "message": "Don't use '--'. Use m-dash — instead",
// "search": " -- ",
// "replace": " — ",
// "searchScope": "text"
// },
// {
// "name": "relative-link",
// "message": "Internal links should start with '/'",
// "searchPattern": "/([\\(\"])[\\w\\-]+\\/docs/g",
// "replace": "$1/en-US/docs",
// "searchScope": "text"
// },
{
"name": "relative-link-path",
"message": "Don't use relative paths",
"search": "](..",
"skipCode": true
"searchScope": "text"
},
{
"name": "trailing-spaces",
"message": "Avoid trailing spaces",
"searchPattern": "/ +$/gm",
"replace": "",
"skipCode": false
"searchScope": "all"
},
// This will be replaced with Prettier in the long run
{
"name": "double-spaces",
"message": "Avoid double spaces",
"searchPattern": "/([^\\s>]) ([^\\s|])/g",
"replace": "$1 $2",
"skipCode": true
"searchScope": "text"
},
{
"name": "stuck-definition",
"message": "Character is stuck to definition description marker",
"searchPattern": "/- :(\\w)/g",
"replace": "- : $1",
"skipCode": true
"searchScope": "text"
},
{
"name": "fqdn-moz-links",
"message": "Don't use developer.mozilla.org for links",
"search": "](https://developer.mozilla.org/",
"message": "Don't use developer.mozilla.org for links, except for blog posts",
"searchPattern": "/\\]\\(https:\\/\\/developer.mozilla.org\\/(?!en-US\\/blog\\/)/g",
"replace": "](/",
"skipCode": true
"searchScope": "text"
}
// XXX Many instances still found in translated content
// {
// "name": "localhost-links",
// "message": "Don't use localhost for links",
// "searchPattern": "/\\]\\(https?:\\/\\/localhost:\\d+\\//g",
// "replace": "](/",
// "searchScope": "text"
// }
]
}
},
Expand Down