Documentation: improve wording and add examples
Add lots of new examples, and add syntax highlighting