fixing the tests to get travis going
some tweaks to the markdown content