Add content to README
Replace the existing README with a new RST version, which is broadly in PEP style