The only Github Action that will open pull request review when a broken link has been found in one of your markdown documentation.

• About the Project
• Github Action

A part of a good developer experience is to ensure that the documentation is accurate. Since most of the repositories depend on different website to get additional detail. This Github action will support you to validate all the links includes in your documentation.

Apply the world in class link checker for your documentation

• 3.1.4 (current version)
• 3.1.3
• 3.1.2
• 3.1.1
• 3.1.0
• 2.2.0
• 2.2.0
• 1.0.1

If you want to use the script on github action:

1. Create a new file in your repository : .github/workflows/markdown-lint.yml
2. Copy paste the informations in your .github/workflows/markdown-lint.yml:

name: Markdown lint

on:
  push:
    branches: [ master ]
  pull_request:
    types: [assigned, opened, synchronize, reopened]

jobs:
  check-links:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: 'restqa-404-links'
      uses: restqa/404-links@3.1.4
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

In order to customize the linter, you will need to create a .404-links.yml configuration file at the root level of your project. Then you can add the following options into the file:

folder: docs/ # The folder that required to be parsed
httpsOnly: true # If you want enforce only HTTPS links
pullRequestReview: true # If you want a nice review in your pull requests
ignore: 
  urls: # Array of url to ignore
    - https://github.com 
    - https://broken/* # wildcard allows
  files: # Array of markdown file the shouldn't parse
    - ./test.md # Relative path from the folder shared above
delay:
  'https://gitlab.com': 500 # Perform a pause of 500ms at each call matching the url

In order to run the code locally you can

• Install the dependencies: npm i
• Run the test npm test

• @olivierodo - 🇫🇷

MIT License

• RestQA

• test automation
• Gherkin
• Cucumber
• End to End
• E2E
• Quality assurance
• QA
• Continuous integration
• RestQa

MIT License