fix readme links and add some more elaboration