Skip to content

chore: check .md files with markdownlint-cli #1803

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 19 commits into from
May 29, 2025
Merged

chore: check .md files with markdownlint-cli #1803

merged 19 commits into from
May 29, 2025

Conversation

samayer12
Copy link
Contributor

@samayer12 samayer12 commented Feb 10, 2025

Description

While working on #1776, I noticed that we do not use a markdown linter. We should lint our markdown code since it's used to create user-facing documentation. This PR adds markdownlint-cli as a project dependency and configures .md linting upon commit.

Related Issue

Fixes #2120

Relates to #1776

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Other (security config, docs update, etc)

Checklist before merging

Copy link

codecov bot commented Feb 10, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 87.04%. Comparing base (e2dc360) to head (61b5602).
Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #1803   +/-   ##
=======================================
  Coverage   87.04%   87.04%           
=======================================
  Files          68       68           
  Lines        2579     2579           
  Branches      561      561           
=======================================
  Hits         2245     2245           
  Misses        298      298           
  Partials       36       36           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@samayer12 samayer12 closed this Feb 10, 2025
@samayer12 samayer12 deleted the hotfix-md-lint branch February 10, 2025 18:56
@samayer12 samayer12 restored the hotfix-md-lint branch February 10, 2025 18:56
@samayer12 samayer12 reopened this Feb 10, 2025
Copy link

socket-security bot commented Feb 10, 2025

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Updated@​types/​node@​22.15.24 ⏵ 22.15.81001008096100

View full report

@samayer12 samayer12 marked this pull request as ready for review February 10, 2025 20:24
@samayer12 samayer12 requested a review from a team as a code owner February 10, 2025 20:24
@samayer12 samayer12 added the ON HOLD Valid work that is deprioritized, but not blocked label Feb 12, 2025
@samayer12 samayer12 removed the ON HOLD Valid work that is deprioritized, but not blocked label Mar 10, 2025
@samayer12 samayer12 self-assigned this Mar 10, 2025
@samayer12 samayer12 added the ON HOLD Valid work that is deprioritized, but not blocked label Mar 10, 2025
@samayer12 samayer12 force-pushed the hotfix-md-lint branch 2 times, most recently from ba87e2d to eb6e7c0 Compare March 20, 2025 14:48
@cmwylie19 cmwylie19 mentioned this pull request May 7, 2025
5 tasks
github-merge-queue bot pushed a commit that referenced this pull request May 7, 2025
## Description

DOM was introduced to our tsconfig as some point which was a mistake.
Our docs indicate that the _only_ reason to use DOM would be to bring in
the web assembly types into a Pepr module. This PR removes DOM and
updates some error messages that were not correct because they were
looking for variables in the DOM types. This should unblock #1803

## Related Issue

Fixes #
<!-- or -->
Relates to #

## Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [x] Other (security config, docs update, etc)

## Checklist before merging
- [x] Unit,
[Journey](https://github.com/defenseunicorns/pepr/tree/main/journey),
[E2E Tests](https://github.com/defenseunicorns/pepr-excellent-examples),
[docs](https://github.com/defenseunicorns/pepr/tree/main/docs),
[adr](https://github.com/defenseunicorns/pepr/tree/main/adr) added or
updated as needed
- [x] [Contributor Guide
Steps](https://docs.pepr.dev/main/contribute/#submitting-a-pull-request)
followed

Signed-off-by: Case Wylie <[email protected]>
@samayer12
Copy link
Contributor Author

Use of markdownlint-cli requires DOM to be set in the tsconfig.json because of katex. See npm list katex:

[email protected] /Users/sam.mayer/code/work/pepr
└─┬ [email protected]
  └─┬ [email protected]
    └─┬ [email protected]
      └── [email protected]

As a workaround, we could remove markdownlint-cli as part of the build command. That approach needs a little more investigation.

@samayer12 samayer12 removed the ON HOLD Valid work that is deprioritized, but not blocked label May 29, 2025
@samayer12
Copy link
Contributor Author

Since this is only a dev-tool that we do not need to distribute, we could use npx to just run the command as-needed in the hooks.

@github-project-automation github-project-automation bot moved this from 🆕 New to 👀 In review in Pepr Project Board May 29, 2025
@cmwylie19 cmwylie19 enabled auto-merge May 29, 2025 16:24
@cmwylie19 cmwylie19 added this pull request to the merge queue May 29, 2025
Merged via the queue into main with commit c7f74b4 May 29, 2025
84 of 87 checks passed
@cmwylie19 cmwylie19 deleted the hotfix-md-lint branch May 29, 2025 16:39
@github-project-automation github-project-automation bot moved this from 👀 In review to ✅ Done in Pepr Project Board May 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: ✅ Done
Development

Successfully merging this pull request may close these issues.

Ensure quality of markdown docs with a linter
2 participants