bevy/docs
FlyingRatBull b399a374cb GitHub Action: Check local Markdown links on push (#2067)
Adds an GitHub Action to check all local (non http://, https:// ) links in all Markdown files of the repository for liveness.
Fails if a file is not found.

# Goal
This should help maintaining the quality of the documentation.

# Impact
Takes ~24 seconds currently and found 3 dead links (pull requests already created).

# Dependent PRs
* #2064 
* #2065 
* #2066

# Info
See [markdown-link-check](https://github.com/marketplace/actions/markdown-link-check).

# Example output
```
FILE: ./docs/profiling.md

1 links checked.

FILE: ./docs/plugins_guidelines.md

37 links checked.

FILE: ./docs/linters.md
[✖] ../.github/linters/markdown-lint.yml → Status: 400 [Error: ENOENT: no such file or directory, access '/github/workspace/.github/linters/markdown-lint.yml'] {
  errno: -2,
  code: 'ENOENT',
  syscall: 'access',
  path: '/github/workspace/.github/linters/markdown-lint.yml'
}
```

# Improvements
* Can also be used to check external links, but fails because of:
  * Too many requests (429) responses:
```
FILE: ./CHANGELOG.md
[✖] https://github.com/bevyengine/bevy/pull/1762 → Status: 429
```
   * crates.io links respond 404
```
FILE: ./README.md
[✖] https://crates.io/crates/bevy → Status: 404
```
2021-05-02 20:22:32 +00:00
..
cargo_features.md Update cargo_features.md (#1939) 2021-04-16 18:57:08 +00:00
debugging.md Grammar correction (#856) 2020-11-15 11:33:21 -08:00
linters.md GitHub Action: Check local Markdown links on push (#2067) 2021-05-02 20:22:32 +00:00
linux_dependencies.md Add note about linker errors for Fedora users (#2009) 2021-04-27 02:41:34 +00:00
plugins_guidelines.md Fix broken link in plugin guidelines (#1513) 2021-03-03 23:17:48 +00:00
profiling.md Documenting small things here and there.. (#706) 2020-10-21 15:57:03 -07:00
release_checklist.md Release Checklist (#1834) 2021-04-08 21:33:46 +00:00