To help the community and make sure that all documentation is up to date and correct, a very important role to play is to make sure all links are working correctly.
To do this, you can use simple tools such as markdown-link-check.
- Install
markdown-link-check
. - Clone the Kubernetes Community repo:
git clone https://github.com/kubernetes/community
cd community
- Create a simple configuration file for
markdown-link-check
within your project root, call it something like `broken-check.json:
{
"replacementPatterns": [
{
"pattern": "^/",
"replacement": "/your/project/root/"
}
]
}
- Run
markdown-link-check
against the files you want to check:
- Single file:
markdown-link-check -c broken-check.json README.md
- Recursive:
find . -name \*.md -exec markdown-link-check -qv -c broken-check.json {} \;