I've never understood why people even _generate_ from the docs folder. If you've written it in markdown (which they nearly always do) then it's already rendered properly in Github. Or is it because they then publish those docs somewhere else?
ghusto · · focus · HN ↗
etatester · · focus · HN ↗
An example:
- source: <a href="https://github.com/eslint/eslint/blob/main/docs/src/rules/no-control-regex.md" rel="nofollow">https://github.com/eslint/eslint/blob/main/docs/src/rules/no...
- rendered: <a href="https://eslint.org/docs/latest/rules/no-control-regex" rel="nofollow">https://eslint.org/docs/latest/rules/no-control-regex
This is a very simple example, you can see how the code blocks are highlighted better and slightly interactive.