* ci: change markdown linting to use the NodeJs markdownlint
The original ruby based markdownlint has a few shortcomings not known
when it was introduced:
- no support for myst extensions
- no support for disabling specific rules for specific files or regions
These two combined make it very hard to use when used for this project
when it has false positives around myst extensions.
Luckily there's a NodeJS based version of markdownlint [1] supporting the
same ruleset that is more configurable:
- seems to support myst extensions better
- has an html comment based syntax to disable specific rules
The library seem to be better maintained too and with better tooling:
e.g. there's a vscode extension using the engine for local use:
markdownlint (DavidAnson.vscode-markdownlint).
[1]: https://github.com/DavidAnson/markdownlint
* docs: hotfix empty links
There are missing links in the docs, these should get fixed, but for now
they are just monkey patched to make CI happy.
* docs: fix links
---------
Co-authored-by: Nara Prasetya <nara@streamhpc.com>
