Skip to content
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

Markdown link checker? #310

Closed
sfmig opened this issue Feb 21, 2024 · 5 comments
Closed

Markdown link checker? #310

sfmig opened this issue Feb 21, 2024 · 5 comments
Assignees
Labels
question Further information is requested

Comments

@sfmig
Copy link
Contributor

sfmig commented Feb 21, 2024

What is the Topic of Your Question

Pre-commit hooks

Add Your Question Below

Should we add a pre-commit hook that checks links are alive in markdown files?

Something like this.

I found it useful recently 😬

@sfmig sfmig added the question Further information is requested label Feb 21, 2024
@paddyroddy
Copy link
Member

Not saying we shouldn't, but we already have link checking in CI https://github.com/UCL-ARC/python-tooling/blob/main/.github/workflows/links.yml (which is quite flaky)

@dstansby
Copy link
Member

I think having a link checker would generate too many false negatives (e.g. when a website happens to be down) to be used in a pre-commit hook, which is run on every commit. How about adding a tox environment that runs a link check? That way it would be easy to run it manually occasionally.

@paddyroddy
Copy link
Member

I don't think we need both, we have it in CI. Considering flakiness is expected, I think just having CI (which can be re-run) should be enough.

@sfmig
Copy link
Contributor Author

sfmig commented Feb 21, 2024

CI only sounds good!

@paddyroddy
Copy link
Member

Thanks for the suggestion @sfmig, closing 🦀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
question Further information is requested
Projects
None yet
Development

No branches or pull requests

4 participants