Skip to content

Introduce mdformat pre-commit hook#3287

Open
C-Achard wants to merge 1 commit intomainfrom
cy/mdformat-hook-docs
Open

Introduce mdformat pre-commit hook#3287
C-Achard wants to merge 1 commit intomainfrom
cy/mdformat-hook-docs

Conversation

@C-Achard
Copy link
Copy Markdown
Collaborator

@C-Achard C-Achard commented Apr 21, 2026

Summary

  • Adds mdformat v1.0 as a pre commit hook with the myst plugin. This helps automate formatting of documentation and catch any mistakes in structure or syntax, making docs maintenance easier.
  • Fixes a small issue with metadata checks being incorrectly run on docs audits files in tools/ .

Scope

  • As a hook with write permissions, it is meant to run locally, not in CI

## Summary

Adds `mdformat` v1.0 as a pre commit hook with the myst plugin.
This helps automate formatting of documentation and catch any mistakes in structure or syntax, making docs maintenance easier.

## Scope

As a hook with write permissions, it is meant to run locally, not in CI.
@C-Achard C-Achard self-assigned this Apr 21, 2026
@C-Achard C-Achard added enhancement New feature or request documentation documentation updates/comments labels Apr 21, 2026
@C-Achard C-Achard requested a review from deruyter92 April 21, 2026 11:58
@C-Achard
Copy link
Copy Markdown
Collaborator Author

One annoyance to note with this : if one has e.g. a technically invalid bullet list which still renders fine(e.g. because of extra newlines), this might try to "fix" it by making every bullet a 1.
I assume there may be other places where the ruleset fixes what isn't broken, which puts a bit more pressure on careful review. Worth thinking about before merging.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation documentation updates/comments enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants