wip

doc-build/md038.md

@@ -1,31 +1,44 @@
-This rule is triggered for code spans that have content with spaces next to the
-beginning or ending backticks:
+This rule is triggered for code spans that have content with unnecessary spaces
+next to the beginning or ending backticks:
 
 ```markdown
 `some text `
 
 ` some text`
+
+`   some text   `
 ```
 
-To fix this, remove any spaces at the beginning or ending:
+To fix this, remove extra spaces from the beginning or ending:
 
 ```markdown
 `some text`
 ```
 
-Note: Code spans containing only spaces are allowed by the specification:
+Note: Code spans containing only spaces are allowed by the specification and are
+preserved:
 
 ```markdown
-` ` or `   `
+` `
+
+`   `
 ```
 
 Note: A single leading *and* trailing space is allowed by the specification and
-automatically trimmed by the parser (in order to allow for code spans that embed
-one or more backticks):
+trimmed by the parser to support code spans that begin or end with a backtick:
+
+```markdown
+`` `backticks` ``
+
+`` backtick` ``
+```
+
+Note: When single-space padding is present in the input, it will be preserved
+even if unnecessary:
 
 ```markdown
-`` `backticks` `` or `` backtick` ``
+` code `
 ```
 
-Rationale: Violations of this rule are usually unintentional and may lead to
+Rationale: Violations of this rule are usually unintentional and can lead to
 improperly-rendered content.

doc/Rules.md

@@ -1528,36 +1528,49 @@ Aliases: `no-space-in-code`
 
 Fixable: Some violations can be fixed by tooling
 
-This rule is triggered for code spans that have content with spaces next to the
-beginning or ending backticks:
+This rule is triggered for code spans that have content with unnecessary spaces
+next to the beginning or ending backticks:
 
 ```markdown
 `some text `
 
 ` some text`
+
+`   some text   `
 ```
 
-To fix this, remove any spaces at the beginning or ending:
+To fix this, remove extra spaces from the beginning or ending:
 
 ```markdown
 `some text`
 ```
 
-Note: Code spans containing only spaces are allowed by the specification:
+Note: Code spans containing only spaces are allowed by the specification and are
+preserved:
 
 ```markdown
-` ` or `   `
+` `
+
+`   `
 ```
 
 Note: A single leading *and* trailing space is allowed by the specification and
-automatically trimmed by the parser (in order to allow for code spans that embed
-one or more backticks):
+trimmed by the parser to support code spans that begin or end with a backtick:
+
+```markdown
+`` `backticks` ``
+
+`` backtick` ``
+```
+
+Note: When single-space padding is present in the input, it will be preserved
+even if unnecessary:
 
 ```markdown
-`` `backticks` `` or `` backtick` ``
+` code `
 ```
 
-Rationale: Violations of this rule are usually unintentional and may lead to
+Rationale: Violations of this rule are usually unintentional and can lead to
 improperly-rendered content.
 
 <a name="md039"></a>

doc/md038.md

@@ -6,34 +6,47 @@ Aliases: `no-space-in-code`
 
 Fixable: Some violations can be fixed by tooling
 
-This rule is triggered for code spans that have content with spaces next to the
-beginning or ending backticks:
+This rule is triggered for code spans that have content with unnecessary spaces
+next to the beginning or ending backticks:
 
 ```markdown
 `some text `
 
 ` some text`
+
+`   some text   `
 ```
 
-To fix this, remove any spaces at the beginning or ending:
+To fix this, remove extra spaces from the beginning or ending:
 
 ```markdown
 `some text`
 ```
 
-Note: Code spans containing only spaces are allowed by the specification:
+Note: Code spans containing only spaces are allowed by the specification and are
+preserved:
 
 ```markdown
-` ` or `   `
+` `
+
+`   `
 ```
 
 Note: A single leading *and* trailing space is allowed by the specification and
-automatically trimmed by the parser (in order to allow for code spans that embed
-one or more backticks):
+trimmed by the parser to support code spans that begin or end with a backtick:
+
+```markdown
+`` `backticks` ``
+
+`` backtick` ``
+```
+
+Note: When single-space padding is present in the input, it will be preserved
+even if unnecessary:
 
 ```markdown
-`` `backticks` `` or `` backtick` ``
+` code `
 ```
 
-Rationale: Violations of this rule are usually unintentional and may lead to
+Rationale: Violations of this rule are usually unintentional and can lead to
 improperly-rendered content.