readme and schema updates