final fixes and updates to the readme to make it more understandable