make sure that the readme is clear and obvious for newcomers. No one expects that the instructions will be buried somewhere in some obscure java class