Documentation update

- add some formatting and links (also, typos)
- link the Theme class from the theming page