a better and a saner readme