Remove old comment
More background/justification
Tweak markdown
Change into tempdir to run tests, and remove bzrlib coupling
Encode/decode file IO as UTF-8 so tests pass on py3