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

Uhm, so this is hard to review.

I'm going to punt on the manual changes themselves for now, other than
noting that ' that we have no immediate plans it to be so' is whack.

The sphinx framework glue is fugly. Makes me sad. Oh well, should be alright.

The manual on pypi's project page looks like it will become test
authors only, I'm not convinced that that is good - is there something
we can do to address that?

Land when happy,
Rob