Skip to content

Conversation

mayomatsuda
Copy link

Add github workflow to check markdown links for broken links before pushing.

Resolves #464

@gpeb2 gpeb2 self-requested a review October 4, 2024 11:35
@gpeb2 gpeb2 added documentation Improvements or additions to documentation enhancement New feature or request labels Oct 7, 2024
Copy link
Collaborator

@gpeb2 gpeb2 left a comment

Choose a reason for hiding this comment

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

Thank you for this contribution and apologies for not reviewing it sooner.
Whilst this pull request currently adds the Markdown link checker GitHub action, as suggested in the issue, merging this as it is will block any future pull requests until all of the broken links that the action finds are fixed.

To get a list of the broken links it is possible to run the action locally using the act tool. Fixing them then requires either putting in an exclusion pattern/rule (i.e. for example URLs), or finding the new/correct link and replacing it.

mayomatsuda and others added 25 commits January 14, 2025 22:37
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

* finish link fixes

* finish link fixes

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

* finish link fixes

* finish link fixes

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
mayomatsuda and others added 13 commits April 13, 2025 14:09
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

* finish link fixes

* finish link fixes

* rename workflow

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

* finish link fixes

* finish link fixes

* rename workflow

* test

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

* finish link fixes

* finish link fixes

* rename workflow

* test

* undo test

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

* finish link fixes

* finish link fixes

* rename workflow

* test

* undo test

* fix links

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
* dev-markdown-link-check: add github workflow to check markdown links. Resolves cambridge-cares#464

* fix markdown links

* fix broken links

* fix readmes

* fix links

* fix broken links and configure github action

* add on merge for modified files

* fix config

* add on merge fix

* finish link fixes

* finish link fixes

* rename workflow

* test

* undo test

* fix links

* fix config

---------

Co-authored-by: Myles MacDonald <mylesmacdonald@Myless-Mac-mini.local>
@@ -0,0 +1,65 @@
{
"ignorePatterns": [
Copy link
Author

Choose a reason for hiding this comment

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

certain links prevent the workflow from working even though they're fine, e.g. dropbox. I've added such to this list. The workflow is buggy with header references (#) and mailto so ignoring those as well.

and ignoring /user, /explore and /images/defaults because it's part of the website code

@mayomatsuda mayomatsuda requested a review from gpeb2 April 14, 2025 01:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Run link checker on Markdown files
2 participants