Skip to content

Automated Link/URL checker #6207

Description

@dhmlau

Suggestion

I'd like to propose to use GitHub Action to check whether links referenced in our docs exist. Possible criteria:

  • check on each pull request on loopback-next - if the changes in PR causes any broken links
    • if it has broken link, mark CI as failed
  • run a cron job (maybe in loopback.io?) - run daily or periodically to make sure we don't have broken links
    • if it has broken link, open a PR automatically
  • able to specify an ignore list - we have quite a lot of references on http://localhost:3000/explorer or similar URL for the API explorer.
  • (optional) able to specify the directory to be scanned - supposedly we only want to scan /docs folder

Some investigation

I did some investigation and found https://github.com/marketplace/actions/link-checker might be the closest of what we want, but it doesn't have the "ignore list" capability.

Note: I wasn't able to get it to show as error in the checks yet at the time of opening this issue, it might be because I don't have the right configuration.
Screen Shot 2020-08-26 at 9 00 31 PM

Metadata

Metadata

Assignees

Labels

Internal ToolingIssues related to our tooling and monorepo infrastructore

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions