Update README

General tidy up, and also document the new class parameters