schema corrections

and some other finetuning in the readme