further improvements to the readme