Improve handbook linter
Follow-up for #6695 (closed)
Known limitations
-
There is a list of ignored paths. Linter does not report broken links located there. - #8514 (closed) (in progress)
-
Linter does not check anchor-only links - !63037 (merged)
✅ -
Linter checks only relative links starting with
/handbook
- Does not work when link starts with
//handbook
- Does not work when link is absolute (ex.
http://about.gitlab.com/handbook/...
) - Does not work when link is relative to the current location (
../product/technical-writing/
)
- Does not work when link starts with
-
Linter cannot validate links to dynamically generated pages (https://about.gitlab.com/handbook/hiring/charts/sales/)
-
Linter only works with
.md
files (.haml
and.erb
are not supported) -
Linter understands links to redirects pages but does not fully validate them
-
Linter does not validate links to images
Example page - https://about.gitlab.com/blog/2018/03/19/use-cases-for-epics/
Edited by Vasilii Iakliushin