Skip to content

Add link checker for Gatsby Docs #19267

@muescha

Description

@muescha

Summary

There is a plugin for a remark Link check: https://www.gatsbyjs.org/packages/gatsby-remark-check-links/

Can this also work on the Gatsby docs/Blog?

Or as a PR check?

new edit:

Ideas

  • check local links

    • add a linter to check before it is submitted
      • check if it has a local domain name (A lint rule is WIP)
      • check if local domains begin with a ., .. or /
    • allow local domain and remove local domain on build time with a transformer
  • check local anchors

    • with a linter and analyse each linked file?
    • on gatsby develop/gatsby build via a graphql query to query all headers?
  • check internal links for trailing slashes (because breadcrumbs and selected sidebar is depend on it)

    • check with linter
  • check external links

    • HEAD request
    • with blc (broken link checker)
  • check internal link files (like doc-links.yml, redirects.yml)

    • with a link checker script (like site showcase validator)

possible tools

Metadata

Metadata

Assignees

No one assigned

    Labels

    help wantedIssue with a clear description that the community can help with.type: documentationAn issue or pull request for improving or updating Gatsby's documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions