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

Fix broken links and update link checking docs #2327

Merged
merged 3 commits into from
Oct 10, 2024

Conversation

BigLep
Copy link
Member

@BigLep BigLep commented Oct 7, 2024

This is done in support of #2319

@BigLep
Copy link
Member Author

BigLep commented Oct 7, 2024

This is the branch protection rule I want to enable:
https://github.com/filecoin-project/filecoin-docs/settings/rules/2131088
github com_filecoin-project_filecoin-docs_settings_rules_2131088

The key callouts are:
For the main branch...

  1. Require PRs
  2. Require PRs to have one approval before merging
  3. Require comments to be resolved before merging
  4. Require linkChecker to pass before merging
  5. Block force pushes

I will enable this once it gets approval

@BigLep BigLep self-assigned this Oct 7, 2024
@BigLep BigLep requested review from eshon and lanzafame October 7, 2024 20:24
@BigLep BigLep marked this pull request as ready for review October 7, 2024 20:31
@BigLep
Copy link
Member Author

BigLep commented Oct 7, 2024

@eshon and @lanzafame : I think this is ready for review. Please look at #2327 (comment) as well.

README.md Outdated
@@ -30,6 +31,10 @@ This repository manages the documentation for the [Filecoin network](https://fil

Want to help out? Pull requests (PRs) are always welcome! If you want to help out but aren't sure where to start, check out the [issues board](https://github.com/filecoin-project/filecoin-docs/issues).

### Link checking

Links are checked using [lychee-action](https://github.com/lycheeverse/lychee-action) as confirugred by [check-external-links.yml](.github/workflows/check-external-links.yml). Working links are required before merging. If you have a link that should be excluded from checking use [`.lycheeignore`](https://github.com/lycheeverse/lychee-action?tab=readme-ov-file#excluding-links-from-getting-checked)
Copy link
Collaborator

Choose a reason for hiding this comment

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

I would add that raw links need backticks and not <code> blocks around them to work with the link checker.

Copy link
Member Author

Choose a reason for hiding this comment

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

@lanzafame : i think <code> block works too. I have updated the README.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Ahh good to know

@BigLep BigLep merged commit 6354f02 into main Oct 10, 2024
3 checks passed
@BigLep BigLep deleted the biglep/cleanup-and-improve-link-checking branch October 10, 2024 06:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: ☑️ Done (Archive)
Development

Successfully merging this pull request may close these issues.

2 participants