Grab your popcorn…
“I can feel the rant calling to me like the green goblin mask, but to keep things snappy before I get into that, let me put some guidelines here. If your language docs do not have the following features, you should very seriously consider rewriting them:”
https://walnut356.github.io/posts/language-documentation/