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

ci: add check for markdown links #912

Merged
merged 8 commits into from
May 3, 2023
Merged

ci: add check for markdown links #912

merged 8 commits into from
May 3, 2023

Conversation

mpoke
Copy link
Contributor

@mpoke mpoke commented May 2, 2023

Description

Closes: NA

Add CI check for markdown links in ./docs and fixing broken links


Author Checklist

All items are required. Please add a note to the item if the item is not applicable and
please add links to any relevant follow up issues.

I have...

  • Included the correct type prefix in the PR title
  • Targeted the correct branch (see PR Targeting)
  • Provided a link to the relevant issue or specification
  • Reviewed "Files changed" and left comments if necessary
  • Confirmed all CI checks have passed

Reviewers Checklist

All items are required. Please add a note if the item is not applicable and please add
your handle next to the items reviewed if you only reviewed selected items.

I have...

  • Confirmed the correct type prefix in the PR title
  • Confirmed all author checklist items have been addressed
  • Confirmed that this PR does not change production code

@shaspitz
Copy link
Contributor

shaspitz commented May 2, 2023

FILE: docs/docs/validators/overview.md
[✖] https://github.com/cosmos/ics-testnets/blob/main/docs/Consumer-Chain-Start-Process.md

might be trying to point here?

# Checks the status of hyperlinks in *.md files in docs/
- uses: gaurav-nelson/github-action-markdown-link-check@1.0.13
with:
folder-path: "docs"
Copy link
Contributor

Choose a reason for hiding this comment

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

Use docs/docs, please.

docs/docs is the only folder that gets published on the docs web page:

Nothing outside of docs/docs is available on the docs web page. Not anything else should be linted for broken links.
You can check this branch to confirm:

The branch is controlled by this action:

Copy link
Contributor

Choose a reason for hiding this comment

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

Its a bit odd to use docs / docs, but beyond the scope of this PR to look into it

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Given that we have .md files in docs, we should make sure that everything there works. Otherwise we should just remove it. For example, docs/old/testing.md contains info that we refer to from the main README.md.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Now that I think about it, we should probably check README.md also for broken links.

Copy link
Contributor

@MSalopek MSalopek left a comment

Choose a reason for hiding this comment

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

LGTM!

@mpoke mpoke merged commit 0a000ff into main May 3, 2023
@mpoke mpoke deleted the marius/check_md_links branch May 3, 2023 12:33
@shaspitz shaspitz mentioned this pull request May 12, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants