Skip to content

⚙️ [Maintenance]: Fix Docs Lint pipeline (MD060 tables + codespell false positives)#52

Merged
Marius Storhaug (MariusStorhaug) merged 2 commits into
mainfrom
docs/51-fix-md060-table-style
Jul 1, 2026
Merged

⚙️ [Maintenance]: Fix Docs Lint pipeline (MD060 tables + codespell false positives)#52
Marius Storhaug (MariusStorhaug) merged 2 commits into
mainfrom
docs/51-fix-md060-table-style

Conversation

@MariusStorhaug

@MariusStorhaug Marius Storhaug (MariusStorhaug) commented Jul 1, 2026

Copy link
Copy Markdown
Member

The Docs pipeline's Lint job (super-linter) is green again. It had been failing on main since the Continuous-X / DevOps guides were added, and every pull request inherited the failure because super-linter validates the entire codebase.

Fixed: Docs Lint pipeline passes again

Two independent problems in the guide files added by 99d9d5a were blocking the job:

  • MD060 / table-column-style (36 errors) in continuous-x-and-continuous-ai.md and devops-reference.md. The tables mixed padded header/body cells (| # |) with compact delimiter rows (|---|). Fixed by padding the delimiter rows so each table uses one consistent style — the rendered tables are unchanged.
  • codespell false positives surfaced once MD060 was resolved. Both are legitimate text, not typos, so they are added to the codespell ignore-words-list rather than "corrected":
    • Skelton — the surname of Matthew Skelton, co-author of Team Topologies.
    • erformance — an artifact of the SPACE-framework acronym **P**erformance (Satisfaction, Performance, Activity, Communication, Efficiency).

Technical Details

  • src/docs/Ways-of-Working/continuous-x-and-continuous-ai.md, src/docs/Ways-of-Working/devops-reference.md: delimiter rows padded (rows 10, 23, 76, 85 and 12, 60). Verified with markdownlint-cli2 (markdownlint v0.41.0) against .github/linters/.markdown-lint.yml — 0 errors.
  • .github/linters/.codespellrc: ignore-words-list extended with skelton,erformance (alongside the existing afterall). Verified with codespell — 0 errors.
  • Full super-linter run is green (MARKDOWN, SPELL_CODESPELL, and all other linters) and Build passes.

This follows Option A from the issue (reformat the tables), plus the codespell false-positive handling needed to actually turn the Lint job green.

Related issues

@MariusStorhaug Marius Storhaug (MariusStorhaug) marked this pull request as ready for review July 1, 2026 10:20
@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title ⚙️ [Maintenance]: Fix MD060 table lint failures blocking the Docs pipeline ⚙️ [Maintenance]: Fix Docs Lint pipeline (MD060 tables + codespell false positives) Jul 1, 2026
@MariusStorhaug Marius Storhaug (MariusStorhaug) merged commit 43397c8 into main Jul 1, 2026
21 checks passed
@MariusStorhaug Marius Storhaug (MariusStorhaug) deleted the docs/51-fix-md060-table-style branch July 1, 2026 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fix MD060 table lint failures blocking the Docs pipeline

1 participant