Make docs link to other relevant documentation

This rewrite some of the documentation and adds links to relevant
documentation where appropriate.