ci: require one sentence per line #24

Open
mvhutz wants to merge 2 commits from ci/one-sentence-per-line into main
Owner

Description

We should adopt the "One sentence per line" principle for mark-up languages. Nick Groenen's post on the subject describes the benefits clearly.

Design Decisions

  • Updated markdownlint config to markdownlint-cli2 config. The former does not allow custom markdown rules.
  • Created a NPM project to repository, to run custom rules with markdownlint-cli2. We could continue to use Docker by overriding the entrypoint of the file, but it doing so comes with complexity. It is more common to just use an NPM project.

Checklist

  • Tests pass
  • Docs updated
## Description We should adopt the "One sentence per line" principle for mark-up languages. [Nick Groenen's post](https://nick.groenen.me/notes/one-sentence-per-line/) on the subject describes the benefits clearly. ### Design Decisions - Updated `markdownlint` config to `markdownlint-cli2` config. The former does not allow custom markdown rules. - Created a NPM project to repository, to run custom rules with `markdownlint-cli2`. We could continue to use Docker by overriding the entrypoint of the file, but it doing so comes with complexity. It is more common to just use an NPM project. ## Checklist - [x] Tests pass - [x] Docs updated
mvhutz added 2 commits 2026-05-16 21:26:27 +00:00
feat: using node version of markdown-lint, no custom rule
Some checks failed
CI / Check PR Title (pull_request) Successful in 46s
CI / Makefile Lint (pull_request) Failing after 1m23s
CI / Markdown Lint (pull_request) Failing after 49s
CI / Go Lint (pull_request) Successful in 1m33s
CI / Unit Tests (pull_request) Successful in 55s
CI / Fuzz Tests (pull_request) Successful in 1m52s
CI / Mutation Tests (pull_request) Successful in 1m31s
89bf93de8f
Some checks failed
CI / Check PR Title (pull_request) Successful in 46s
Required
Details
CI / Makefile Lint (pull_request) Failing after 1m23s
Required
Details
CI / Markdown Lint (pull_request) Failing after 49s
Required
Details
CI / Go Lint (pull_request) Successful in 1m33s
Required
Details
CI / Unit Tests (pull_request) Successful in 55s
Required
Details
CI / Fuzz Tests (pull_request) Successful in 1m52s
Required
Details
CI / Mutation Tests (pull_request) Successful in 1m31s
Required
Details
Some required checks were not successful.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin ci/one-sentence-per-line:ci/one-sentence-per-line
git checkout ci/one-sentence-per-line
Sign in to join this conversation.