Skip to content

#284 fix markdownlint violations in README.md - #290

Open
VasilevNStas wants to merge 1 commit into
zerocracy:masterfrom
VasilevNStas:284-fix-markdownlint
Open

#284 fix markdownlint violations in README.md#290
VasilevNStas wants to merge 1 commit into
zerocracy:masterfrom
VasilevNStas:284-fix-markdownlint

Conversation

@VasilevNStas

Copy link
Copy Markdown
Contributor

Problem

Every push to master fails the markdown-lint workflow with 10 errors. CI has been red since June 13.

Root cause

PR #246 ("Rewrite README with full documentation and quick start guide") was created on June 8 — before the markdown-lint workflow had a pull_request trigger (that was added by PR #240 on June 13). When #240 was merged, nobody pushed to #246's branch to re-trigger CI. GitHub Actions does not automatically re-run checks on open PRs when a new workflow lands on the base branch.

Result: #246 was merged with 10 markdownlint violations, and they've blocked CI on every push to master since.

Timeline (June 13):

Time PR Event
07:16 #240 pull_request trigger added to markdown-lint workflow
07:30 #246 Merged — introduces 10 markdownlint errors in README.md
07:44 #235 Merged on top — same errors, same CI failure

Violations fixed

Line Rule Fix
18 MD040 Fenced code block without language → ```text
44, 59, 77, 83 MD029 List prefix 2./3./4./5.1.
94 MD060 Table separator `
97 MD013 Long line suppressed via <!-- markdownlint-disable MD013 --> wrapping the table

Long‑term prevention

This scenario (open PR bypasses a new CI workflow on master) could have been avoided if the branch protection rules required markdown-lint as a mandatory status check. Without that, any PR opened before a new workflow is added to the repo can slip through — even with the pull_request trigger now in place.

Verification

markdownlint-cli2 v0.23.0 (markdownlint v0.41.0)
Finding: README.md
Linting: 1 file(s)
Summary: 0 error(s)

Checklist

  • bundle exec rubocop — 0 offences
  • bundle exec rake — all tasks pass
  • HoC ≤ 133

@yegor256 please review

PR zerocracy#246 rewrote README.md and introduced 10 markdownlint
violations. Since its branch was created before the
markdown-lint workflow had a pull_request trigger (zerocracy#240),
the errors were never caught before merge. They block CI
on every push to master.

This PR fixes all 10 violations: adds language to code fence,
normalises ordered list prefixes, fixes table column style,
and wraps the wide table in an MD013 disable/enable block.
@VasilevNStas
VasilevNStas requested a review from yegor256 as a code owner July 9, 2026 20:09
@VasilevNStas

Copy link
Copy Markdown
Contributor Author

@yegor256 plz review this

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.

1 participant