document how to get tests running

plus some random formatting stuff