Docs overhaul. NB also removes unused 'validate' args from load/dump funcs.

Restructure docs - intro is now on the front page.
Rewrite intro to flow a bit better.
Clean up all the docstrings into uniform Napoleon approved format.