Skip to content

chore(markdown-lint): setup markdownlint to lint md files and avoid having errors#1072

Open
gabrielseco wants to merge 9 commits into
mainfrom
setup-markdownlint
Open

chore(markdown-lint): setup markdownlint to lint md files and avoid having errors#1072
gabrielseco wants to merge 9 commits into
mainfrom
setup-markdownlint

Conversation

@gabrielseco

@gabrielseco gabrielseco commented Jun 3, 2026

Copy link
Copy Markdown
Collaborator

Add markdownlint to avoid having errors in changelogs mostly me :)

Note

Low Risk
Documentation and dev-tooling only; no runtime or application logic changes.

Overview
This PR adds markdownlint as a first-class check for repo documentation, wired into local scripts, CI, and editor setup.

Tooling: markdownlint-cli is added as a dev dependency with lint:md / lint:md:fix scripts and inclusion in the ci npm script. Configuration lives in .markdownlint.json (defaults on, with several rules turned off for CHANGELOG-style docs) and .markdownlintignore for build/output paths.

CI: PR and main workflows run npm run lint:md in the lint-and-format job after JS lint.

Developer experience: VS Code recommends the markdownlint extension and enables markdownlint (and ESLint) fix-on-save; DEVELOPMENT.md documents commands, rule choices, and CI behavior.

Doc touch-ups: A few markdown files are adjusted to satisfy the new linter (e.g. heading spacing in CHANGELOG.md, blank lines around fenced blocks, table formatting in schema docs).

Reviewed by Cursor Bugbot for commit 645f18a. Bugbot is set up for automated code reviews on this repo. Configure here.

@github-actions

github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

📦 Bundle Size Report

Metric Current Previous Change Status
Total (gzip) 215.46 kB 215.46 kB +1 B (+0.0%) 🔴
Total (raw) 585.74 kB 585.74 kB 0 B (0%) 🟢
CSS (gzip) 20.89 kB 20.89 kB 0 B (0%) 🟢
CSS (raw) 109.09 kB 109.09 kB 0 B (0%) 🟢

Size Limits

  • ✅ Total gzipped: 215.46 kB / 250 kB (86.2%)
  • ✅ Total raw: 585.74 kB / 600 kB (97.6%)
  • ✅ CSS gzipped: 20.89 kB / 25 kB (83.5%)

Largest Files (Top 5)

  1. chunk-UGPYPGVV.js - 14 kB (0 B (0%))
  2. styles.css - 10.44 kB (0 B (0%))
  3. index.css - 10.44 kB (0 B (0%))
  4. chunk-MT7H2K34.js - 6.36 kB (0 B (0%))
  5. index.js - 6.14 kB (-2 B (-0.0%))
View All Files (317 total)
File Size (gzip) Change
chunk-UGPYPGVV.js 14 kB 0 B (0%)
styles.css 10.44 kB 0 B (0%)
index.css 10.44 kB 0 B (0%)
chunk-MT7H2K34.js 6.36 kB 0 B (0%)
index.js 6.14 kB -2 B (-0.0%)
chunk-4YW6P3IJ.js 6.01 kB 0 B (0%)
chunk-EFL7QFFN.js 5.29 kB 0 B (0%)
chunk-2ADIF2YA.js 4.76 kB 0 B (0%)
chunk-ONMQSOSC.js 4.47 kB new
chunk-OQQ4JHSR.js 3.89 kB 0 B (0%)

✅ Bundle size check passed

@github-actions

github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

📊 Coverage Report

⚪ Coverage unchanged

Metric Current Previous Change Status
Lines 89.97% 89.97% 0%
Statements 89.63% 89.63% 0%
Functions 87.15% 87.15% 0%
Branches 80.26% 80.26% 0%

Detailed Breakdown

Lines Coverage
  • Covered: 3802 / 4226
  • Coverage: 89.97%
  • Change: 0% (0 lines)
Statements Coverage
  • Covered: 3864 / 4311
  • Coverage: 89.63%
  • Change: 0% (0 statements)
Functions Coverage
  • Covered: 1031 / 1183
  • Coverage: 87.15%
  • Change: 0% (0 functions)
Branches Coverage
  • Covered: 2371 / 2954
  • Coverage: 80.26%
  • Change: 0% (0 branches)

✅ Coverage check passed

@github-actions

github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Deploy preview for remote-flows ready!

Project:remote-flows
Status: ✅  Deploy successful!
Preview URL:https://remote-flows-irtpn8zay-remotecom.vercel.app
Latest Commit:645f18a

Deployed with vercel-action

@gabrielseco gabrielseco marked this pull request as ready for review June 3, 2026 18:32

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit ff86492. Configure here.

Comment thread package.json
@remotecom remotecom changed the title Setup markdownlint chore(markdown-lint): setup markdownlint to lint md files and avoid having errors Jun 5, 2026
@gabrielseco gabrielseco self-assigned this Jun 5, 2026
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