Make the README file worth reading
Bring documentation up to standard