Fleshed out the tests documentation

The doctest bit still needs some work, I've never really used it myself
so not sure what the benefits are :)