Is it a good idea to use BNF for documentation? This form of document doesn't seem to be very useful for people who want to use the language. Both WASM and jav

Is it a good idea to use BNF for documentation? This form of document doesn't seem to be very useful for people who want to use the language. Both WASM and javascript docs do this, and it is also the same here https://c9x.me/compile/doc/il.html https://c9x.me/compile/doc/il.html I think LLVM's IR document is not easy to read, this one is not better. I don't want to reimplement a compiler for the IR language, I want to know how to use it, how to generate code using it. I need to see examples, i.e. how to implement threading, coroutine, weakly typed variables, reflection ... not the BNF.