Code review comment for lp:~jml/testtools/more-doc-improvements

Thanks guys. Martin, I look forward to seeing your '(more...)'. Vincent, I've made those changes. Rob, I think the best thing to do is to have an "overview" document and make that the PyPI page. I can do that before landing the branch.