artefactual / archivematica

Free and open-source digital preservation system designed to maintain standards-based, long-term access to collections of digital objects.
http://www.archivematica.org
GNU Affero General Public License v3.0
429 stars 103 forks source link

Fix broken links in Markdown files #1996

Closed replaceafill closed 2 months ago

replaceafill commented 2 months ago

This also introduces markdown-link-check as a pre-commit hook to check broken links in the Markdown files of the repository. The hook has been set as manual to not interfere in the usual development workflow.

For example, to check links in a specific file:

pre-commit run --hook-stage manual markdown-link-check --files src/dashboard/frontend/README.md

Or to check all the Markdown files in the repository:

pre-commit run --hook-stage manual markdown-link-check --all-files

We should not include this in the pull request workflow because link checking is flaky. Sometimes working links fail from GitHub hosts because websites block them. But we could potentially create a separate workflow that developers could trigger manually.