document language syntax/semantics

[ejrgilbert]

https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html

[ahuoguo]

I think we are looking for something like mdbook https://rust-lang.github.io/mdBook/

This is the tool that generates https://pest.rs/book/