From 2d7084da3328f2e7f4f0cf4082395e2bc4b41409 Mon Sep 17 00:00:00 2001
From: Paul Gottschling <paul.gottschling@goteleport.com>
Date: Tue, 26 Nov 2024 09:56:12 -0500
Subject: [PATCH] Disable some formatting linters (#508)

Disable linting rules for Markdown syntax that only affect formatting
conventions and do not affect user experience:

- Emphasis marker (`_this syntax_` and `*this syntax*` are both
  acceptable)
- Unordered list marker (can use asterisks and hyphens)
- Ordered list marker (can use all `1.`s or sequential numbers)
---
 .remarkrc.mjs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.remarkrc.mjs b/.remarkrc.mjs
index 5d798247e0..972f175690 100644
--- a/.remarkrc.mjs
+++ b/.remarkrc.mjs
@@ -5,14 +5,12 @@ import remarkCodeSnippet from "./.build/server/remark-code-snippet.mjs";
 import remarkLintDetails from "./.build/server/remark-lint-details.mjs";
 import remarkLintFrontmatter from "./.build/server/remark-lint-frontmatter.mjs";
 import remarkTOC from "./.build/server/remark-toc.mjs";
-import { remarkLintTeleportDocsLinks} from "./.build/server/lint-teleport-docs-links.mjs"
+import { remarkLintTeleportDocsLinks } from "./.build/server/lint-teleport-docs-links.mjs";
 import {
   getVersion,
   getVersionRootPath,
 } from "./.build/server/docs-helpers.mjs";
-import {
-  loadConfig,
-} from "./.build/server/config-docs.mjs";
+import { loadConfig } from "./.build/server/config-docs.mjs";
 
 const configFix = {
   settings: {
@@ -35,6 +33,8 @@ const configLint = {
     "frontmatter",
     "mdx",
     "preset-lint-markdown-style-guide",
+    ["lint-emphasis-marker", false],
+    ["lint-unordered-list-marker-style", false],
     ["lint-table-pipe-alignment", false],
     ["lint-table-cell-padding", false],
     ["lint-maximum-line-length", false],
@@ -46,7 +46,7 @@ const configLint = {
     ["lint-list-item-spacing", { checkBlanks: true }],
     ["lint-no-shell-dollars", false],
     ["lint-list-item-indent", "space"],
-    ["lint-ordered-list-marker-value", "single"],
+    ["lint-ordered-list-marker-value", false],
     ["lint-maximum-heading-length", false],
     ["lint-no-shortcut-reference-link", false],
     ["lint-no-file-name-irregular-characters", false],