More reorganisation and clarificaction in doc/README.md. Added more section headings