Update readme and some class docs