fix(docs): markdownlint config without line limits; fix lint findings #1

2026-10-09T12:56:11Z

KofTwentyTwo commented

2026-10-09 12:56:11 +00:00

(Migrated from github.com)

What

Adds configs/markdown/.markdownlint-cli2.jsonc (and a copy at the root): every default markdownlint rule except MD013 line length, which K22-CODE-08 says we don't limit, plus a short list of allowed HTML (<details>, <summary>, …).
Fixes the 17 non-length findings from the first docs run: unlabeled code blocks, bold text used as headings in the exception register, double blank lines and a bare email in the Code of Conduct, spaces inside a code span.

Why

The first CI run on main failed the docs job: 655 of its 672 findings were line-length errors from markdownlint's default 80-column rule, which contradicts our own standard.

How tested

npx markdownlint-cli2@0.23.3 "**/*.md" (the version CI pins): 0 issues in 57 files.

Generated with Claude Code

## What - Adds `configs/markdown/.markdownlint-cli2.jsonc` (and a copy at the root): every default markdownlint rule except **MD013 line length**, which K22-CODE-08 says we don't limit, plus a short list of allowed HTML (`<details>`, `<summary>`, …). - Fixes the 17 non-length findings from the first `docs` run: unlabeled code blocks, bold text used as headings in the exception register, double blank lines and a bare email in the Code of Conduct, spaces inside a code span. ## Why The first CI run on `main` failed the `docs` job: 655 of its 672 findings were line-length errors from markdownlint's default 80-column rule, which contradicts our own standard. ## How tested `npx markdownlint-cli2@0.23.3 "**/*.md"` (the version CI pins): 0 issues in 57 files. Generated with [Claude Code](https://claude.com/claude-code)

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: KofTwentyTwo/standards#1