From 768631dfbc8f463d906beba78cbe24711947d979 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 10 Feb 2025 18:57:33 +0000 Subject: [PATCH 1/3] auto-fix markdownlint issues on save --- .vscode/settings.json | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.vscode/settings.json b/.vscode/settings.json index b6cc11639..1058d3f38 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -20,4 +20,7 @@ "editor.wrappingIndent": "same", "editor.wordWrapColumn": 120, "editor.rulers": [120], + "editor.codeActionsOnSave": { + "source.fixAll.markdownlint": "always" + } } \ No newline at end of file From 84348b0aedbf86853bf1a84164b5ff546b4a6072 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 10 Feb 2025 18:58:39 +0000 Subject: [PATCH 2/3] Add to README --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 5c4c72321..761a102f7 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,16 @@ We'll be working on follow-ups to make this more user-friendly, but it's now wor * Open the root of the project (`/`, not `/docs`) * Run `markdownlint-cli2 --config ".github/linters/.markdownlint.yml" "docs/**/*.md"` +We recommend adding the following settings to your VSCode environment if they don't come through in the repository: + +```json + "editor.codeActionsOnSave": { + "source.fixAll.markdownlint": "always" + } +``` + +This will fix 80% of the markdown linting issues for you upon save. + We'd love your contributions! See [The contributing guide](CONTRIBUTING.md) for how to get involved. ## Building the API docs locally From fb72b9e60128a9e22866401b9681fa40ac21ec0d Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 10 Feb 2025 19:01:08 +0000 Subject: [PATCH 3/3] remove line size from markdown linting --- .github/linters/.markdownlint.yml | 5 +---- .markdownlintrc | 7 +------ 2 files changed, 2 insertions(+), 10 deletions(-) diff --git a/.github/linters/.markdownlint.yml b/.github/linters/.markdownlint.yml index 01dbaabc1..7bc093fed 100644 --- a/.github/linters/.markdownlint.yml +++ b/.github/linters/.markdownlint.yml @@ -19,10 +19,7 @@ # Rules by id # ############### MD024: false -MD013: - line_length: 120 - code_blocks: false - tables: false +MD013: false MD026: false MD046: false # Mix of indented and fenced code blocks MD004: false diff --git a/.markdownlintrc b/.markdownlintrc index d9509f680..ca285c6af 100644 --- a/.markdownlintrc +++ b/.markdownlintrc @@ -1,11 +1,6 @@ { "MD024": false, - "MD013": { - "line_length": 123, - "code_blocks": false, - "tables": false - - }, + "MD013": false, "MD026": false, "MD046": false, "MD004": false