And yet more readme stuff

I got to document this stuff for my colleagues and make sure it's
properly done.